findscripter 何时使用
当你要给 Agent 配一套 X/Twitter 数据 + 自动化工具箱、并自行选 REST / MCP / SDK / CLI 接入方式时使用。典型场景：
- 读数据：按关键词、话题标签、
from:user、"精确短语"及高级运算符搜索推文；取用户资料（bio、粉丝/关注数）、某条推文完整指标（赞、转、回复、引用、浏览、收藏）；检查 A 是否关注 B（双向）；查区域趋势话题（免费、不计配额）。 - 批量抽取：粉丝、关注、已验证粉丝、提及、帖子、回复、转推、引用、长帖、文章、社区、列表、Space、人物搜索、媒体、点赞等共 23 类抽取工具；下载推文媒体、导出结果。
- 监控：账号监控（新推文/回复/转推/引用/粉丝变化）+ HMAC 签名 Webhook 实时推送；或轮询事件。
- 写操作（须审批）：发推、回复、点赞、转推、关注/取关、发私信；从推文回复随机抽奖。
- 运行时插件：Hermes Agent 用 Hermes Tweet（
tweet_explore/tweet_read/审批门控tweet_action）；OpenClaw 用 TweetClaw（explore/tweetclaw）。
不该用的边界（本工作流为 critical 风险）：
- 没有有效
XQUIK_API_KEY。 - 操作未获授权的账号或目标；任何写操作（发推/回复/点赞/转推/关注/取关/私信/建监控/注册 webhook/启动批量抽取）必须先取得用户显式批准。
- 想绕过 X 反爬、登录墙或自建分布式爬虫——本技能只调托管的 Xquik 平台。
- 目标是非 X/Twitter 平台。
- 必填输入、权限、安全边界或成功标准不明确时，先停下来澄清。
- 本条目为文档型指引，不含可执行爬虫/二进制/内置运行时；Xquik、Hermes Tweet、TweetClaw 须自行审阅并单独安装。
步骤
- 装工具（按运行时三选一）：
- 通用：
npx skills add Xquik-dev/x-twitter-scraper - Hermes Agent：
hermes plugins install Xquik-dev/hermes-tweet --enable - OpenClaw：
openclaw plugins install @xquik/tweetclaw
- 通用：
- 拿 API Key：在 xquik.com 注册 → 控制台生成 → 设环境变量：
export XQUIK_API_KEY="xq_YOUR_KEY_HERE" - 选接入方式：直连 REST（脚本）/ MCP（AI 原生集成）/ 官方 SDK（TS、Python、Ruby、Go、Kotlin、Java、PHP、C#、CLI、Terraform 任选）。
- 判定读/写：读操作直接走；写操作先把草稿/目标/影响呈给用户，获批后再调。
- 批量前估成本：启动批量抽取前先
/extractions/estimate估算配额/费用，再/extractions启动。 - 导出/汇总：给出条数、文件位置、关键洞察。
指令
接入参数（保留源约束）：
- Base URL：
https://xquik.com/api/v1 - Auth：请求头
x-api-key: xq_... - MCP：
https://xquik.com/mcp（StreamableHTTP，同一把 API Key）
核心端点速查：
| 端点 | 方法 | 用途 |
|---|---|---|
/x/tweets/{id} |
GET | 单条推文 + 完整指标 |
/x/tweets/search |
GET | 搜索推文 |
/x/users/{username} |
GET | 用户资料 |
/x/followers/check |
GET | 关注关系 |
/trends |
GET | 趋势话题 |
/monitors |
POST | 创建监控 |
/events |
GET | 轮询监控事件 |
/webhooks |
POST | 注册 webhook |
/draws |
POST | 运行抽奖 |
/extractions |
POST | 启动批量抽取 |
/extractions/estimate |
POST | 估算抽取成本 |
/drafts |
POST | 创建推文草稿 |
/styles |
POST | 分析/应用推文风格 |
/account |
GET | 账号与用量信息 |
Hermes Tweet 工具：tweet_explore（端点发现）、tweet_read（只读调用）、tweet_action（写/私有动作，审批门控）。TweetClaw 工具：explore（发现）、tweetclaw（已批准调用）。
示例
均为提示词级用法，写操作走"先草稿后审批"：
搜索：在 X 上搜过去一周关于 'claude code' 的推文
用户：@elonmusk 是谁？给我资料和粉丝数
互动：这条推文 https://x.com/... 有多少赞和转推？
抽奖：从这条推文的回复里随机抽 3 名中奖者
监控：监控 @openai 的新推文并通过 webhook 通知我
批量：导出 @anthropic 的全部粉丝
发布（需审批）：拟一条对这条推文的回复，我确认最终文案后再发
Hermes：用 Hermes Tweet 搜这次发布、读推文回复，准备一条待审批的回复草稿
设置密钥（直连 REST 示例头）：
export XQUIK_API_KEY="xq_YOUR_KEY_HERE"
# curl -H "x-api-key: $XQUIK_API_KEY" "https://xquik.com/api/v1/x/tweets/search?query=claude+code"
注意事项
- 风险等级 critical：本工作流会自动化已认证的 X 账号动作。仅对你有权操作的账号与目标使用。
- 写操作审批门：发推/回复/点赞/转推/关注/取关/私信/建监控/注册 webhook/启动批量抽取——一律先取得用户显式批准。优先用
tweet_read（只读）探查，写走tweet_action（审批门控）。 - 密钥安全：
XQUIK_API_KEY（xq_前缀）切勿硬编码进源码、客户端 JS、镜像或日志；走环境变量，泄露即在控制台轮换。 - 配额与成本：趋势查询免费不计配额；批量抽取按量计费，启动前用
/extractions/estimate估算。 - Webhook：事件带 HMAC 签名，接收端务必校验签名再处理。
- 合规：遵守 X/Twitter 平台条款与当地法律；输出不替代环境内人工核验与专家审查。仅当任务明确落在上述范围内时使用本技能。
互见
- related：
x-twitter-automation—— 同源同平台（Xquik）的自动化条目，可视为本工具箱的姊妹篇。 - related：
apify-ecommerce-scraper、browser-automation-builder—— 其他平台数据抽取/浏览器自动化，可拼成跨平台情报流水线。 - combines_with：社媒发布/内容创作/表现分析类技能 —— 由编排技能触发本工具做定时搜索、监控与发布。
- combines_with：把监控/Webhook 事件转发到 Slack/IM 的通知类技能 —— 串成账号监控 + 实时告警闭环。
采编自 sickn33/antigravity-awesome-skills（MIT）；上游致谢 Xquik（xquik.com）。本条目为适配重写，接口、配额与合规细节请按自身环境验证，写操作须经显式审批。