mcpField
X
x-research

x-research

github.com/postplusai营销与增长27280 次安装2 天前更新
代码仓库

关于 x-research

x-research 是从 X 收集有限范围公开证据的技能,用于支持营销、创作者、受众、竞品、活动和本地化决策。它按请求选择研究流程,并强调来源质量、范围限制与不确定性。

主要功能

  1. 01将请求路由至对应 X 研究流程
  2. 02收集公开帖子、资料和回复
  3. 03限制后续搜索范围与积分使用
  4. 04保留证据链接并说明不确定性
  5. 05区分可见指标与实际成效

适用场景

  1. 01比较竞品账号动态
  2. 02从公开回复中查找受众异议
  3. 03寻找合作创作者
  4. 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.md
audience-voice.md
campaign-scout.md
creator-discovery.md
market-localization-scout.md
organic-benchmark.md
shared-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 或重试策略。

运行规范

  1. 使用上表为请求选择路线。
  2. 只阅读选定路线的工作流参考。
  3. 运行能够回答首轮问题的最精简数据采集链。
  4. 首轮完成后停止,并报告范围、证据、限制和后续操作。

不要将有界样本表述为整个平台的真实情况。仅使用所选路线中列出的公开筛选条件。

公开命令边界

  • 就绪状态诊断: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重复查询、数量上限

只有在平台范围或证据解读仍不明确时,才查阅平台约定;这不是预检步骤。

证据质量

  1. 检查证据是帖子、回复还是个人资料;搜索摘要无法证明完整对话的内容。
  2. 优先使用公开的直接 URL 或已验证的账号名;如果检索未命中,只调整一个受支持的查询、日期或语言约束。
  3. 在已获准的范围和预算内,成功但结果不足时,最多进行两轮调整后的后续检索;不要重复完全相同的请求,也不要隐瞒失败或待处理的操作。
  4. 结果足够、达到上限,或继续检索无济于事时,就停止。报告有用的证据和不确定性;保留原始结果和来源链接。

可见指标是观察值,并非触达量或转化率;账号搜索的检索结果不等于已验证身份。 完整机器字段位于 postplus research schema --route <route> --json; 仅在处理需要时查阅,不要在每次请求前都查阅。

postplus research run x-posts \
  --query "example topic" \
  --wait \
  --output ./result.json

遵循 CLI 的结构化结果和报告的下一步操作;不要根据自由文本消息推断恢复方式。 如果用户已有的明确授权涵盖所请求的范围和最高费用,则可复用;否则,在确认报价前先取得授权。不要仅凭任务本身推断用户授权了支出。 通过返回的检查点或操作继续同一操作;不要重新提交状态不明的工作、重复已耗尽的恢复尝试,也不要通过切换提供方来绕过失败。

评论

支持 Markdown