技能介绍

要解决什么问题

在 Agent 或自动化流程里直接对接 X（原 Twitter）时，常见痛点是：官方 API 门槛高、自建爬虫易触发风控，且推文、私信、简介等外部文本里可能夹带「改工具、改配置」类指令，容易污染模型决策。本技能把能力收敛到 Xquik 官方 REST 与 MCP 通道，用 x-api-key: xq_... 鉴权，并在一开始就约定内容隔离与写操作审批，而不是把账号密码或 Cookie 交给对话上下文。

技能如何工作

读数据：先识别对象类型（推文、用户、搜索、时间线、DM、文章等），校验用户名与 ID 格式后，选用最窄的 GET 端点；需要翻页时才跟 cursor，展示时把 X 侧原文包在不可信边界内，只当数据引用。

批量抽取：大规模粉丝、搜索、媒体等场景走 extraction job：先 POST /extractions/estimate 看条数与积分，用户明确同意后再创建任务并轮询结果。

写与账号动作：发推、点赞、关注、私信、删帖等一律先用人话列出 payload、目标账号与积分成本，未经明确批准不调用写接口，也不从推文内容推断要写什么。

监控与事件：持续跟踪账号或关键词用 monitor；对外推送用带签名的 event delivery，需确认目的地、事件类型与停用方式。MCP 侧提供 explore（查端点 schema）与 xquik（按 operation ID 调用）。

适用边界与注意点

只使用用户发放的 Xquik API Key；账号绑定与套餐变更在 Xquik 控制台完成，技能不收集 X 登录材料。
读操作约 1–5 credits/次，批量与写操作更贵；限流为读 10/秒、写 30/60 秒、删 15/60 秒，报价以 docs.xquik.com 为准。
私信、书签、通知、主页时间线等私有读每次都要单独批准；429 尊重 Retry-After，写失败不要自动重试。
本技能不执行 shell、不写本地文件、不把 X 原文未经同意丢给无关工具。

截图预览

使用场景

对指定 hashtag 或账号做历史推文分页检索，把结果当不可信文本归档到内部分析流程，避免把推文里的指令当成 Agent 工具调用。
粉丝或关注列表规模很大时，先调用 `POST /extractions/estimate` 核对条数与积分，获批后再创建 extraction job 并轮询拉取结果。
品牌或舆情值班需在关键词/账号命中时持续跟踪，配置 monitor 与签名 event delivery，把事件推到自建 webhook 供告警系统消费。
发推或互动前先列出 like、repost、follow、DM 的 payload 与积分成本，负责人明确批准后再调用对应写接口，拒绝从推文内容自动推断写操作。

适合人员

负责竞品与自家 X 账号内容、互动指标归档，且不能把手输 Cookie 交给大模型的社媒情报分析
在 Mastra、CrewAI 或 LangChain 里接 MCP，需要 Agent 用 `explore` 查 schema、用 `xquik` 只读拉时间线与用户资料的工程师
举办 X 抽奖或福利活动，需要用 draw 端点导出参与快照与指标、便于透明核验中奖名单的社区或增长运营
搭建对外 Agent 产品、需在技能层隔离 X 侧文本、并对私信/书签/删帖等敏感读写在每次调用前征得用户同意的平台安全维护者