bluesky-reader

Original：🇺🇸 English
Translated

Read public Bluesky feeds via the AT Protocol API. Fetch recent posts from any public profile or search a profile's posts by keyword. No authentication required. Use for "read bluesky", "check bluesky feed", "search bluesky posts".

19installs
Sourcenotque/claude-code-toolkit
Added on

NPX Install

npx skill4agent add notque/claude-code-toolkit bluesky-reader

Tags

Translated version includes tags in frontmatter
bluesky-readerat-protocol-apipublic-feed-accesspost-searchcommand-line-tool

SKILL.md Content

View Translation Comparison →

Bluesky Reader Skill

Read public Bluesky profiles via the AT Protocol public API. No auth needed.

Commands

bash
# Fetch recent posts
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --limit 20

# Search posts by keyword (fetches feed, filters locally)
python3 ~/.claude/scripts/bluesky_reader.py search --handle HANDLE --query "search terms"

# JSON output for pipeline consumption
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --json

# Pagination
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --cursor CURSOR_STRING

API Details

  • Endpoint: 
    https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed
  • Auth: None (public endpoint)
  • Limit: 1-100 posts per request
  • Search: Local keyword filter -- all query words must appear (case-insensitive)

When to Use

  • Gathering recent Bluesky posts from a specific person for research
  • Searching a profile's posts for mentions of a topic
  • Feeding Bluesky content into a news or content pipeline

Exit Codes

CodeMeaning
0Success
1Error (network failure, invalid handle, no posts found)