Back to Details

bluesky-reader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bluesky Reader Skill

Bluesky Reader Skill

Read public Bluesky profiles via the AT Protocol public API. No auth needed.
通过AT Protocol公开API读取Bluesky公开个人资料，无需身份验证。

Commands

命令

bash
undefined
bash
undefined

Fetch recent posts

获取最新帖子

python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --limit 20
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"
python3 ~/.claude/scripts/bluesky_reader.py search --handle HANDLE --query "搜索关键词"

JSON output for pipeline consumption

输出JSON格式以便流水线处理

python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --json
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --json

Pagination

分页

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

API Details

API详情

  • 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)
  • 接口地址: 
    https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed
  • 身份验证: 无（公开接口）
  • 数量限制: 每次请求可获取1-100条帖子
  • 搜索规则: 本地关键词过滤——所有查询词必须出现（大小写不敏感）

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
  • 为研究需求收集特定用户的Bluesky最新帖子
  • 搜索个人资料中提及某一主题的帖子
  • 将Bluesky内容接入新闻或内容处理流水线

Exit Codes

退出码

CodeMeaning
0Success
1Error (network failure, invalid handle, no posts found)
代码含义
0成功
1错误（网络故障、无效账号、未找到帖子）