# bsky.md — Bluesky as Markdown

Fetch any public Bluesky profile, post, feed, or search as clean Markdown.
No auth. No API key. Just HTTP.

  https://bsky.md

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## Quick start

  curl https://bsky.md/profile/j4ck.xyz
  curl https://bsky.md/profile/mackuba.eu
  curl https://bsky.md/profile/mackuba.eu/posts
  curl https://bsky.md/profile/j4ck.xyz/followers
  curl "https://bsky.md/search?q=atproto"
  curl https://bsky.md/trending

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## Endpoints

  /profile/:handle                    Bio, stats, pinned post
  /profile/:handle/posts              Recent posts (paginated)
  /profile/:handle/post/:rkey         Single post with embeds
  /profile/:handle/post/:rkey/thread  Full thread
  /profile/:handle/feed/:rkey         Public custom feed
  /profile/:handle/followers          Follower list
  /profile/:handle/following          Following list
  /search?q=:query                    Full-text post search
  /links?url=:url                     Posts linking to a URL or domain
  /trending                           Trending topics right now
  /llms.txt                           Machine-readable API guide (for agents)
  /skill.md                           Agent skill file (Claude, Cursor, Windsurf…)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## More examples

  # Thread
  curl https://bsky.md/profile/mackuba.eu/post/<rkey>/thread

  # Custom feed
  curl https://bsky.md/profile/bsky.app/feed/whats-hot

  # Pagination
  curl "https://bsky.md/profile/mackuba.eu/posts?limit=5"

  # Search
  curl "https://bsky.md/search?q=%23rust+lang"
  curl "https://bsky.md/search?q=open+source"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## Note on private accounts

Some Bluesky users require sign-in to view their content.
bsky.md only has access to public content — those accounts will return a clear notice.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## Add to your coding agent

  # Claude Code (global /bsky slash command)
  curl -s https://bsky.md/skill.md > ~/.claude/commands/bsky.md

  # Any project (CLAUDE.md / .cursorrules / .windsurfrules)
  curl -s https://bsky.md/skill.md >> CLAUDE.md

  # GitHub Copilot
  mkdir -p .github && curl -s https://bsky.md/skill.md >> .github/copilot-instructions.md

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Source: https://tangled.org/j4ck.xyz/bsky-md