mcpField
B
bluesky-research

bluesky-research

github.com/crawlora-org其他139 次安装2 天前更新
代码仓库

关于 bluesky-research

通过 Crawlora 以标准化 JSON 获取 Bluesky 公开资料、帖子、讨论串、关注关系、账号搜索结果和趋势话题。适用于账号与对话研究，无需抓取应用页面或直接使用 AT Protocol 客户端。

主要功能

  1. 01查询资料与账号数据
  2. 02获取作者动态和帖子讨论串
  3. 03查看粉丝及关注列表
  4. 04按资料文本搜索账号
  5. 05获取趋势话题

适用场景

  1. 01查看账号资料和近期动态
  2. 02阅读帖子的回复及上级讨论串
  3. 03梳理账号的粉丝与关注网络
  4. 04搜索研究所需的账号或话题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill bluesky-research

安装后在 Claude Code 中输入/bluesky-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

Bluesky 研究

通过 Crawlora API 查询公开的 Bluesky 个人资料、作者动态、帖子讨论串、关注者/关注关系图、账号搜索和热门话题 — 全部以规范化 JSON 返回，无需抓取应用内容或直接使用 AT Protocol 客户端。

适用场景

  • “Bluesky 上 的个人资料 / 关注者数量是多少？”
  • “获取 在 Bluesky 上最近发布的帖子。”
  • “显示这条 Bluesky 帖子的回复 / 讨论串。”
  • “Bluesky 上有哪些账号关注 ？” / “ 关注了哪些账号？”
  • “搜索 Bluesky 上关于 的账号。”
  • “Bluesky 现在有哪些热门话题？”

设置（仅需一次）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 点数，无需银行卡）。
  • 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助脚本从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

选择要执行的任务：

  1. 个人资料 — /bluesky/profile（actor = handle 或 DID）。显示名称、 简介、头像/横幅、关注者数/关注数/帖子数。
  2. 作者动态 — /bluesky/author-feed（actor，可选 cursor、 limit）。按时间从新到旧返回账号帖子的一页，包含互动数以及任何附加图片/链接卡片/引用帖子。
  3. 帖子讨论串 — /bluesky/post-thread（uri = 帖子的 at:// URI， 可选 depth）。返回帖子及其嵌套回复；如果帖子是回复，还会返回其上级帖子链。
  4. 关注者 / 关注关系图 — /bluesky/followers 和 /bluesky/follows （actor，可选 cursor、limit）。分页查看账号的关注者或其关注的账号。
  5. 搜索账号 — /bluesky/search-actors（q，可选 cursor、 limit）。搜索显示名称、handle 和个人资料简介中与查询匹配的账号。
  6. 热门话题 — /bluesky/trending-topics（无参数）。Bluesky 当前的 热门话题和推荐动态。

完整端点列表、方法和参数请参阅：reference/endpoints.md。

调用 API

# Profile + author feed:
scripts/crawlora.sh /bluesky/profile actor=bsky.app | jq '.'
scripts/crawlora.sh /bluesky/author-feed actor=bsky.app limit=20 | jq '.'

# Search + trending:
scripts/crawlora.sh /bluesky/search-actors q="web scraping" | jq '.'
scripts/crawlora.sh /bluesky/trending-topics | jq '.'

所有请求都使用 scripts/crawlora.sh；它会避免将 API 密钥暴露在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Bluesky 端点。

示例

  • 账号审查： 对某个 handle 使用 /bluesky/profile + /bluesky/author-feed， 检查关注者数量、发帖频率和近期互动情况。
  • 获取讨论串： 从作者动态或搜索账号结果中获取帖子的 at:// URI，然后使用 /bluesky/post-thread 阅读完整的回复树（如果帖子本身是回复，还会返回上级帖子链）。
  • 关系网络映射： 对某个账号分页查询 /bluesky/followers 和 /bluesky/follows， 构建其关注者/关注关系图。

备注与限制

  • 点数 / 成功后付费： 仅在返回 2xx 时计费；免费套餐每月 2,000 点数。 密钥可在 https://crawlora.net 获取。
  • 仅限公开数据 — 数据源是 AT Protocol 的公开、无需凭据的 AppView API，包含公开个人资料/帖子；无需登录，不含私密内容。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中 — 切勿将其硬编码、作为查询参数传递或提交到代码库。
  • 列表端点（author-feed、followers、follows、search-actors）采用 游标分页 — 使用返回的 cursor 获取后续页面。
  • post-thread 需要完整的 at:// 帖子 URI，而非 bsky.app URL — 请从 author-feed 或 search-actors 结果中的帖子 uri 字段获取。
  • trending-topics 无参数，而且明确是此类端点中最不稳定的接口 — Bluesky 可能随时更改其数据结构。

评论

支持 Markdown