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".

2installs

Sourcenotque/claude-code-toolkit

Added on2026-03-24

NPX Install

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

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

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