用途:查询公开 Threads(Meta)资料、帖子与回复,并执行关键词搜索,结果是 Crawlora API 返回的规范化 JSON,不依赖应用抓取或非官方客户端库。适用于查询某公开资料及粉丝数、提取某帖正文与回复、查看某用户近期发帖、检索话题或品牌提及,以及竞品社媒聆听与品牌监测。
主要能力:
- 资料:/threads/profile/{username} 获取公开资料元数据(简介、计数)。
- 资料帖子:/threads/profile/{username}/posts 获取公开帖子,通过不透明游标分页。
- 单帖:/threads/post/{username}/{code} 获取帖子正文、作者、规范链接与预览图。
- 帖子回复:/threads/post/{username}/{code}/replies 获取公开回复。
- 搜索:/threads/search 获取某查询的公开搜索结果第一页。
使用方式:先在 https://crawlora.net 获取免费 Crawlora API key(每月 2,000 credits,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,再用 scripts/crawlora.sh 发起请求,例如: scripts/crawlora.sh /threads/profile/zuck | jq '.' scripts/crawlora.sh /threads/search q="web scraping" | jq '.' 所有请求都走脚本,避免密钥出现在命令行参数中。helper 从环境变量读取 CRAWLORA_API_KEY 并请求 https://api.crawlora.net/api/v1,缺失或无效密钥返回 401。完整端点列表与方法参数见 reference/endpoints.md。
限制:仅限公开数据,不登录、不访问私密内容,需遵守 Threads 条款。按成功计费,仅 2xx 计费。搜索无继续游标,只返回未登录状态下的第一页结果,无法翻页更深。回复分页为不透明游标,有时缺失——当 Threads 报告存在更多回复但可能不提供可用游标时端点会标注。资料帖子分页需将上一响应中的游标传入以翻过第一页。密钥仅存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库。