用途：在 X/Twitter 上发现显著超出作者粉丝基数的帖子，用于账号增长的选题参考。
主要能力：将细分领域转为短查询词簇，使用 twitterapi.io 高级搜索的 Top 与 Latest；默认不启用宽泛权威账号搜索，避免低粉发现被官方或名人账号主导；提取推文指标与作者粉丝数，并按作者粉丝数、浏览量或互动量过滤；按互动/粉丝、浏览/粉丝、书签/点赞及时间新鲜度等爆发证据排序；输出 JSON 供自动化或 Markdown 供选题审阅。
使用方式：在技能目录运行脚本，例如 python3 scripts/search_x_viral_topic.py --topic "AI agent" --days 7 --max-followers 50000 --min-engagement 100 --limit 50 --format markdown。需设置环境变量 export TWITTERAPI_IO_KEY="..."，也接受 TWITTER_API_KEY 以兼容既有 ai-trend-search 工作流。默认查询形如 ("keyword one" OR "keyword two") lang:en since:YYYY-MM-DD -filter:replies min_faves:20；中文领域可同时使用英文产品词与中文词，查询宜短而多。
输出契约：每条结果保留来源与作者证据，字段包括 platform、content_id、url、title、author_id、author_name、author_handle、follower_count、published_at、view_count、like_count、comment_count、share_count、save_count、hot_score、breakout_score、evidence。修改阈值或与其他平台合并前应阅读 references/scoring.md。
限制：作者粉丝数缺失时不应视为低粉，除非用户明确允许未知粉丝；过宽查询可能返回空或异常响应，需收窄主题并保留 source_status；除非用户明确要求，避免抓取已登录浏览器会话，脚本使用 API 路径；帖子仅作选题信号与钩子，不应整段复制线程内容。