x-research

X（Twitter）研究

通过 Crawlora API 查询公开的 X 个人资料、近期帖子和单条帖子的内容及互动数据 ——所有数据均为标准化 JSON，无需浏览器自动化或官方 X API 访问权限。

何时使用此技能

• “X 上 的个人资料／粉丝数是多少？”
• “获取 在 X 上的近期帖子。”
• “这条 X 帖子说了什么，互动数据如何？”
• 无需 X API 访问权限，在 X 上监测竞争对手或影响者的社交动态。

设置（一次性）

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

工作原理

1. 个人资料 — GET /x/profile/{username} 返回 X 用户名对应的公开个人资料详情， 包括可见计数和个人资料媒体（如有）。
2. 个人资料帖子 — GET /x/profile/{username}/posts 返回公开个人资料第一页载荷中的帖子 （默认 20 条，通过 limit 最多可设为 50 条）。它不会对回复、纯媒体标签页或搜索 结果进行分页。
3. 帖子详情 — GET /x/post/{id} 根据数字帖子 ID 返回单条公开帖子， 包括作者、文本、可见指标，以及引用帖子预览（如有）。传入 username 可要求 作者匹配（不匹配时返回 404）。

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

调用 API

# Profile:
scripts/crawlora.sh /x/profile/nasa | jq '.'

# Profile posts (capped at 50 per page):
scripts/crawlora.sh /x/profile/nasa/posts limit=30 | jq '.'

# Single post, with author check:
scripts/crawlora.sh /x/post/1234567890 username=nasa | jq '.'

所有请求均使用 scripts/crawlora.sh；它能避免 API 密钥出现在命令行参数中。

端点参考

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

示例

• 个人资料快照： /x/profile/<handle>，查看粉丝数、关注数和简介，再决定是否值得跟踪该账号。
• 近期动态检查： /x/profile/<handle>/posts，查看发帖频率和主题，无需翻页查看回复或媒体标签页。
• 查询单条帖子： /x/post/<id>，获取特定帖子的文本和指标，例如查询其他地方分享的链接；也可以通过 username= 验证作者。

注意事项和限制

• 点数／成功才收费： 仅对 2xx 响应计费；免费套餐每月 2,000 点数。 在 https://crawlora.net 获取密钥。
• 仅限公开数据 — 公开个人资料和帖子；无需登录，不提供私密内容。 请遵守 X 的条款。
• 安全性： 密钥仅存于 CRAWLORA_API_KEY 中——切勿硬编码、作为查询参数传递或提交。
• 不支持 X 搜索或趋势查询 — 此技能仅涵盖个人资料、个人资料帖子和帖子详情；没有 /x/search 或趋势端点。
• 个人资料帖子仅返回单页，不支持游标分页 — /x/profile/{username}/posts 只返回第一页载荷中的内容（limit 为 1-50，默认 20）； 不会继续向前遍历时间线。
• 只能通过数字 ID 查询帖子 — /x/post/{id} 需要帖子的数字 ID， 而不是推文 URL 别名或用户名；传入 username 可防止 ID 冲突或不匹配。