bluesky-reader

Featured

Read public Bluesky feeds via AT Protocol API.

AI & Automation 412 stars 42 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 95/100

Stars 20%
87
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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 ## 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` | ## ...

Details

Author
notque
Repository
notque/vexjoy-agent
Created
4 months ago
Last Updated
3 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category