bluesky-reader

name	bluesky-reader
description	Read public Bluesky feeds via AT Protocol API.
user-invocable	false
agent	python-general-engineer
allowed-tools	["Bash","Read"]
routing	{"triggers":["read Bluesky","fetch Bluesky posts","AT Protocol","Bluesky feed","bsky"],"category":"research","pairs_with":["content-calendar"]}

Bluesky Reader Skill

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

Commands

# 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

Reference Loading

Task type	Load this reference
Endpoint details, data shapes, pagination	references/at-protocol-api.md
Debugging fetch errors, wrong output, missing posts	references/at-protocol-preferred-patterns.md
Extending the script with new endpoints or search	references/at-protocol-api.md
Code review of AT Protocol Python code	references/at-protocol-preferred-patterns.md

Exit Codes

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

Reference Loading Table

Signal	Load These Files	Why
Endpoint details, data shapes, pagination	at-protocol-api.md	Routes to the matching deep reference
Debugging fetch errors, wrong output, missing posts	at-protocol-preferred-patterns.md	Routes to the matching deep reference
Extending the script with new endpoints or search	at-protocol-api.md	Routes to the matching deep reference
Code review of AT Protocol Python code	at-protocol-preferred-patterns.md	Routes to the matching deep reference