SuperAPI AI Directory

x-collect

Marketing & growth

View repository

Updated 10-15 23:44

About this skill

X Collect

Collect trending topics and research materials for X content creation using a systematic 4-round web search strategy.

Prerequisites

  • WebSearch tool available
  • Internet connection

Optional State (ContextStore)

If available, leverage user preference state to improve search quality:

  • State dir: ~/.claude/skills/x-create/state/
  • Positive samples: liked_topics.json (preferred topics/entities/sources)
  • Negative samples: rejected_topics.json (avoid low-value/repetitive topics)

If state files don't exist, proceed normally.

Workflow

Input

User provides:

  • Topic (required): The subject to research (e.g., "Latest AI Agent developments", "Claude 4 release")
  • Language (optional): Output language, defaults to Chinese (zh-CN)

4-Round Search Strategy

Simulate human research thinking process with progressive depth.

Query expansion rules (lightweight):

  • Start with user topic
  • Add 2-5 query variants based on:
    • User profile (domains/persona if known)
    • liked_topics.json high-frequency keywords/entities (if available)
  • Keep ~20% queries as exploration (cross-domain / adjacent keywords) to avoid information bubble

Dedup & clustering (at the end of each round):

  • Merge near-duplicate URLs/titles
  • Group materials into topic clusters (rough tags are fine)

Round 1: Official Sources (Authoritative Information)

Search: "{topic} 官方文档"
Search: "{topic} GitHub"
Search: "{topic} official announcement"

Goal: Get authoritative first-hand information

Round 2: Technical Analysis (Technical Breakdown)

Search: "{topic} 详细介绍"
Search: "{topic} 教程 tutorial"
Search: "{topic} how it works"

Goal: Understand technical details and mechanisms

Round 3: Comparison & Reviews (Comparative Evaluation)

Search: "{topic} vs {competitor}"
Search: "{topic} 评测 review"
Search: "{topic} pros cons"

Goal: Get different perspectives and comparisons

Round 4: Supplementary Verification (Supplementary Verification)

# Analyze gaps from previous rounds
missing_info = analyze_gaps(previous_results)
Search: "{missing_info}"
Search: "{topic} 最新 latest 2024 2025"

Goal: Fill information gaps and get latest updates

Output Format

Generate structured material document:

# {Topic} 素材收集报告

## 收集时间
{timestamp}

## 核心信息
- **官方定义**: ...
- **关键特性**: ...
- **最新动态**: ...

## 素材列表

### 素材 1
- **标题**: ...
- **来源**: {url}
- **摘要**: 2-3句话概括
- **关键点**:
  - 要点1
  - 要点2
- **潜在选题角度**: ...
- **推荐推文类型**: [高价值干货/犀利观点/热点评论/故事洞察/技术解析]
- **QualityScore (0-10)**: ...
- **TopicCluster**: ...
- **HookCandidates**:
  - ...

### 素材 2
...

## 热度分析
- **当前热度**: 高/中/低
- **趋势**: 上升/稳定/下降
- **讨论焦点**: ...

## 争议点
- 争议1: ...
- 争议2: ...

## 下一步建议
使用 `/x-filter` 对素材进行打分筛选

Additionally, append a machine-readable block for hooks/state ingestion:

MATERIALS_JSON
{
  "schema_version": "x_skills.materials.v1",
  "topic": "{Topic}",
  "timestamp": "{timestamp}",
  "items": [
    {
      "title": "...",
      "url": "...",
      "summary": "...",
      "key_points": ["..."],
      "quality_score_0_10": 0,
      "topic_cluster": "...",
      "hook_candidates": ["..."]
    }
  ]
}

Execution Steps

  1. Receive topic from user
  2. Execute Round 1 searches (official sources)
  3. Execute Round 2 searches (technical analysis)
  4. Execute Round 3 searches (comparisons)
  5. Analyze gaps from rounds 1-3
  6. Execute Round 4 searches (fill gaps)
  7. Synthesize results into structured format
  8. Output MATERIALS_JSON (for hooks/state ingestion)
  9. (Optional) Append event for feedback loop:
    • python ~/.claude/skills/x-create/scripts/x_state.py event --event collect.completed --payload-json '{"topic":"...","items_count":12,"explore_ratio":0.2}'
  10. Report summary to user

Example

User: /x-collect Claude MCP协议

Expected behavior:

  1. Search "Claude MCP protocol official documentation"
  2. Search "MCP Model Context Protocol GitHub"
  3. Search "MCP protocol detailed introduction"
  4. Search "MCP protocol tutorial"
  5. Search "MCP vs function calling"
  6. Search "MCP protocol review"
  7. Identify gaps: need more about security, adoption rate
  8. Search "MCP protocol security"
  9. Search "MCP protocol latest 2025"
  10. Generate structured material report

Integration

After collection, suggest:

素材收集完成!共找到 X 条相关素材。

下一步:运行 /x-filter 对素材进行打分筛选,≥7分的选题将进入创作池。

Tips

  • For trending topics, prioritize recency (2024-2025)
  • For technical topics, prioritize official docs and GitHub
  • For controversial topics, collect multiple perspectives
  • Always note the source URL for credibility