关于 x-research
x-research 是从 X 收集有限范围公开证据的技能,用于支持营销、创作者、受众、竞品、活动和本地化决策。它按请求选择研究流程,并强调来源质量、范围限制与不确定性。
主要功能
- 01将请求路由至对应 X 研究流程
- 02收集公开帖子、资料和回复
- 03限制后续搜索范围与积分使用
- 04保留证据链接并说明不确定性
- 05区分可见指标与实际成效
适用场景
- 01比较竞品账号动态
- 02从公开回复中查找受众异议
- 03寻找合作创作者
- 04比较 X 上的市场或语言
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill x-research安装后在 Claude Code 中输入/x-research确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/account-and-competitor-audit.mdaudience-voice.mdcampaign-scout.mdcreator-discovery.mdmarket-localization-scout.mdorganic-benchmark.mdshared-contract.md详细介绍
X 研究
当用户需要公开证据来支持营销、创作者、受众、竞争对手、营销活动或本地化决策时,将此作为 X 研究入口。
参考索引
只阅读与请求匹配的一条路线参考。当平台范围仍不明确时,可选读本地约定了解详情。
| 用户询问 | 应用 |
|---|---|
| 已知账号、竞争对手账号、账号对比 | references/account-and-competitor-audit.md |
| 公开帖子、吸引点、形式、主题、竞争对手内容 | references/organic-benchmark.md |
| 回复、受众表达、异议、常见问题、短语库 | references/audience-voice.md |
| 创作者、专家、从业者、合作伙伴、个人资料核实 | references/creator-discovery.md |
| 发布、话题标签、提及、品牌或竞争对手营销活动 | references/campaign-scout.md |
| 市场、地区、语言或跨境对比 | references/market-localization-scout.md |
| 仅需个人资料事实 | 对已知账号使用 x-profiles,或使用 x-user-search 查找账号 |
| 私人账号、私信、隐藏分析数据、完整关注者关系图、广告支出、定向、转化或 ROAS | 停止,或询问是否接受受支持的公开 X 范围 |
| 跨平台请求 | 仅在此处处理 X 部分;将其他平台的任务转交出去 |
首个问题
仅当答案会改变平台、路线、公开/私密边界、首轮范围或输出形式时,才提一个问题。
| 缺失信息 | 询问 |
|---|---|
| 平台 | 我应先使用哪个平台? |
| X 线索 | 请提供一个 X 线索:关键词、话题标签、账号名称、个人资料/帖子 URL、竞争对手、营销活动术语或创作者条件。 |
| 未提供账号的账号审计 | 请发送 X 账号名称/个人资料 URL,或告诉我品牌名称以及可用作查找线索的最接近竞争对手。 |
| 未提供帖子串的受众表达分析 | 请发送公开的 X 帖子 URL,或提供查询词,我会先筛选出一到三个帖子串。 |
| 未提供线索的创作者发现 | 请提供一个细分领域、主题、产品、竞争对手、受众或合作目标。 |
| 未提供市场的本地化分析 | 我应先对比哪个市场或语言? |
不要询问凭据、实现选项、架构、隐藏字段、私人导出数据、Cookie 或重试策略。
运行规范
- 使用上表为请求选择路线。
- 只阅读选定路线的工作流参考。
- 运行能够回答首轮问题的最精简数据采集链。
- 首轮完成后停止,并报告范围、证据、限制和后续操作。
不要将有界样本表述为整个平台的真实情况。仅使用所选路线中列出的公开筛选条件。
公开命令边界
- 就绪状态诊断:
postplus doctor --skill x-research。 - 仅当路线的语义标志尚不明确时,才使用
postplus research run <route> --help检查该路线。 - 运行
postplus research run <route> --<query/handle/url flags> --limit <n> --wait --output <result.json>。 - 仅使用所选路线中显示的语义标志。
- 使用
postplus research run --resume-from <result.json>恢复待处理的运行;切勿提取或改写该检查点中存储的不透明句柄。 - 限定首轮范围。如果命令在执行中的 PostPlus 技能允许的有界恢复操作后仍失败,请报告确切错误并停止;不要悄悄更换数据源,也不要编造缺失数据。
- 请求任务使用现有 PostPlus 额度;执行前先核实当前价格和余额。仅需估价的请求不执行。额度不足时停止;不要充值、购买订阅或重复执行结果不确定的付费操作。
命令选择
| 需求 | 路由 | 标志 |
|---|---|---|
| 帖子、时间线、直接 URL、回复 | x-posts | 重复查询/账号名/URL、排序、数量上限 |
| 已知账号信息 | x-profiles | 重复账号名、数量上限 |
| 按关键词查找账号 | x-user-search | 重复查询、数量上限 |
只有在平台范围或证据解读仍不明确时,才查阅平台约定;这不是预检步骤。
证据质量
- 检查证据是帖子、回复还是个人资料;搜索摘要无法证明完整对话的内容。
- 优先使用公开的直接 URL 或已验证的账号名;如果检索未命中,只调整一个受支持的查询、日期或语言约束。
- 在已获准的范围和预算内,成功但结果不足时,最多进行两轮调整后的后续检索;不要重复完全相同的请求,也不要隐瞒失败或待处理的操作。
- 结果足够、达到上限,或继续检索无济于事时,就停止。报告有用的证据和不确定性;保留原始结果和来源链接。
可见指标是观察值,并非触达量或转化率;账号搜索的检索结果不等于已验证身份。
完整机器字段位于 postplus research schema --route <route> --json;
仅在处理需要时查阅,不要在每次请求前都查阅。
postplus research run x-posts \
--query "example topic" \
--wait \
--output ./result.json
遵循 CLI 的结构化结果和报告的下一步操作;不要根据自由文本消息推断恢复方式。 如果用户已有的明确授权涵盖所请求的范围和最高费用,则可复用;否则,在确认报价前先取得授权。不要仅凭任务本身推断用户授权了支出。 通过返回的检查点或操作继续同一操作;不要重新提交状态不明的工作、重复已耗尽的恢复尝试,也不要通过切换提供方来绕过失败。
评论
支持 Markdown