mcpField
X
xquik-social-data

xquik-social-data

github.com/fudesign2008数据与数据库662 次安装1 天前更新
代码仓库

关于 xquik-social-data

xquik-social-data 是通过 Xquik API 检索当前公开 X/Twitter 内容的技能。它强调小规模、可追溯的证据样本和审慎分析,适用于社交聆听、研究与支持分流。

主要功能

  1. 01搜索公开帖子和账户
  2. 02按帖子 ID 去重
  3. 03保留引用与互动字段
  4. 04附带限定条件归纳主题
  5. 05妥善处理缺失的 API 密钥

适用场景

  1. 01研究产品的公开讨论
  2. 02比较反复出现的主题或投诉
  3. 03构建带引用的 OSINT 证据
  4. 04撰写内容前查看公开动态

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/fudesign2008/open-skills --skill xquik-social-data

安装后在 Claude Code 中输入/xquik-social-data确认已加载。

详细介绍

Xquik 社交数据

当任务需要通过 Xquik 获取最新的公开 X/Twitter 证据时,使用此技能。 以证据为先:获取少量相关样本,引用帖子 ID 或 URL, 并将直接观察与解读区分开来。

使用场景

  • 搜索有关某个主题、品牌、账号、事件、产品或活动的公开帖子。
  • 撰写摘要前,查找公开的 X/Twitter 账号或帖子。
  • 比较公开讨论中的主题、情绪、重复出现的问题或投诉。
  • 为社交聆听、OSINT、营销研究或支持工单分流构建可追溯的证据集。
  • 撰写帖子或建议前,查看趋势或公开活动。

请勿将此技能用于私信、需要登录才能查看的内容、凭据共享、绕过平台限制, 或需要完整官方分析数据的说法。

设置

  • API 基础 URL:https://xquik.com/api/v1
  • 文档:https://docs.xquik.com
  • 身份验证:将用户的 Xquik API 密钥作为 x-api-key 发送。

切勿打印或存储 API 密钥。如果没有 API 密钥,请提供准确的 请求格式,并请用户在其获准环境中运行。

工作流

  1. 明确范围。

    • 主题、账号、日期范围、语言、地理区域和所需输出。
    • 如果用户给出的主题较宽泛,请创建 3 到 8 个简短的搜索查询。
  2. 获取公开证据。

    • 使用 GET /x/tweets/search?q=<query> 搜索帖子。
    • 仅在能直接支持任务时使用账号或帖子端点。
    • 控制每批请求的规模,并按帖子 ID 去重。
  3. 规范化发现结果。

    • 保留 id、text、createdAt、作者用户名、互动数据字段和 URL。
    • 如果计数缺失,请标记为缺失,而非零;API 响应明确显示为零时除外。
    • 每项结论都必须至少关联一个帖子 ID、URL 或账号用户名。
  4. 谨慎分析。

    • 将重复出现的主题分组。
    • 除非用户提供了带标签的数据,否则将情绪标记为解读。
    • 指明样本量、查询偏差、语言偏差和时间范围限制。
  5. 返回简洁的报告。

    • 范围和查询。
    • 证据数量和去重后的数量。
    • 附有引用示例的主要主题。
    • 风险、未知信息和建议的后续搜索。

请求示例

curl "https://xquik.com/api/v1/x/tweets/search?q=launch%20feedback" \
  -H "x-api-key: $XQUIK_API_KEY"
curl "https://xquik.com/api/v1/x/users/search?q=xquik" \
  -H "x-api-key: $XQUIK_API_KEY"

输出模板

## Scope
- Goal:
- Queries:
- Time window:

## Evidence
- Raw results:
- Deduped results:
- Notable examples:

## Findings
1. Theme:
   Evidence:
   Confidence:

## Limits
- Sample size:
- Query bias:
- Missing data:

## Next Searches
1.
2.

质量规则

  • 不得捏造帖子、计数、链接、趋势或账号详情。
  • 不得根据单条帖子推断人口统计信息或意图。
  • 不得泄露机密、原始凭据或私有实现细节。
  • 不得声称已完整覆盖 X/Twitter。除非用户提供了完整导出数据,否则请称其为“样本”。
  • 优先使用确切的 ID 和 URL,而非含糊的摘要。

评论

支持 Markdown