Social Media Scout 是一个跨平台社交媒体数据查询技能，作者为 43 COLLEGE 凯寓（KAIYU），版本 v1.0。它通过 TikHub API 获取 926+ 个社交媒体接口的数据，覆盖抖音、TikTok、小红书、微博、B站、快手、Instagram、YouTube、Twitter、微信公众号等平台。
用途
该技能用于查询社交媒体账号信息、搜索关键词相关内容、获取视频或帖子数据、查看评论、解析分享链接、下载视频、获取微信公众号文章列表以及提取文章内容。
主要能力
- 查询用户资料（抖音、TikTok、小红书等）
- 搜索关键词相关的视频、笔记、帖子
- 通过分享链接解析视频数据
- 获取视频评论、用户粉丝/关注列表
- 查看平台热搜榜单
- 下载无水印视频
- 获取微信公众号文章列表（需 ghid）
- 提取微信公众号指定文章内容
使用方式
首次配置：如果命令报错找不到 config.json、api_key 为占位符、或返回 401，需读取本目录下的 SETUP.md 并按其中流程完成配置。API 配置位于 scripts/config.json，包含 API Key 与 MCP 代理路径。
调用架构有两条路径：MCP 模式使用 https://mcp.tikhub.io/tools/call，需要 tikhub-mcp-proxy.exe 在后台运行；REST 直调使用 https://api.tikhub.io/api/v1/...，无额外依赖，直接 HTTP 调用。call_tool() 已实现自动降级：先尝试 MCP，404 或连接失败时自动切换 REST。也可用 rest_call() 或 CLI rest-call 命令直接走 REST。工具名到 REST 路径的映射规则为 {platform}{module}{method} → /api/v1/{platform}/{module}/{method}。搜索类（工具名含 search）用 POST + JSON body，其余用 GET + query params，猜错会自动 405 重试。
所有命令必须先 cd 到 skill 根目录再执行。示例：python3 scripts/tikhub_client.py call <tool_name> --args '{"param": "value"}'；直接走 REST：python3 scripts/tikhub_client.py rest-call <tool_name> --args '{"param": "value"}'；按平台列出工具：python3 scripts/tikhub_client.py list --platform douyin；按关键词搜索工具：python3 scripts/tikhub_client.py list --keyword search。Python 内联调用时需用绝对路径加载 scripts 目录，并导入 call_tool、rest_call、parse_user_search_results、extract_video_url、download_file 等函数。
常用工具速查
抖音：搜索类推荐 douyin_search_*，如 douyin_search_fetch_general_search_v1、douyin_search_fetch_user_search、douyin_search_fetch_video_search_v1；用户资料可用 douyin_web_handler_user_profile（sec_user_id）、douyin_web_fetch_user_profile_by_uid（uid）、douyin_web_fetch_user_profile_by_short_id（short_id）；作品获取推荐 App 接口 douyin_app_fetch_user_post_videos，Web 接口有分页深度限制约 80 条；单个视频用 douyin_web_fetch_one_video，分享链接解析用 douyin_web_fetch_one_video_by_share_url，高清链接用 douyin_app_fetch_video_high_quality_play_url；互动数据包括 douyin_web_fetch_video_comments、douyin_web_fetch_user_fans_list、douyin_web_fetch_user_following_list、douyin_web_fetch_hot_search_result。
小红书：xiaohongshu_web_get_user_info、xiaohongshu_web_search_notes、xiaohongshu_web_search_users、xiaohongshu_app_get_user_notes（推荐）、xiaohongshu_web_get_user_notes_v2、xiaohongshu_web_get_note_comments。
B站：接口稳定性差，web 和 app 的用户资料/作品列表接口经常 500。搜索用户推荐 bilibili_app_fetch_search_by_type（search_type="bili_user"）；获取粉丝数最稳定的是 bilibili_web_fetch_user_relation_stat（vmid），若 TikHub 接口全部 500，可用 Python 直接调 B站公开 API 作为备选（仅使用内置库）。获取用户视频列表最可靠的方式是 bilibili_web_fetch_user_dynamic（uid, offset），不要用 bilibili_web_fetch_user_post_videos 或 bilibili_app_fetch_user_videos。其他包括 bilibili_web_fetch_one_video、bilibili_web_fetch_video_comments、bilibili_web_fetch_video_danmaku、bilibili_web_fetch_collect_folders、bilibili_web_bv_to_aid、bilibili_web_fetch_com_popular、bilibili_web_fetch_hot_search。下载B站视频需用 yt-dlp，1080P 60帧需要大会员 cookie，普通 1080P 无需登录。
TikTok：tiktok_web_fetch_user_profile、tiktok_web_fetch_user_post、tiktok_web_fetch_post_detail、tiktok_web_fetch_search_video、tiktok_web_fetch_post_comment。通用混合解析可用 hybrid_video_data（url）。
微信公众号：TikHub 的微信公众号接口必须直接调用 REST API，不能走 MCP 工具系统（/tools 端点返回 404）。接口包括 fetch_mp_article_list（ghid 必填）、fetch_mp_article_detail_json（仅支持短链）、fetch_mp_article_detail_html（短链/长链均支持）、fetch_mp_article_comment_list、fetch_mp_article_url、fetch_mp_related_articles。TikHub 无按公众号名称搜索的接口，必须从一篇该公众号的文章 URL 中提取 ghid。
适用场景
适用于需要跨平台采集社交媒体公开数据的场景，例如账号调研、内容搜索、评论分析、热搜追踪、视频下载、公众号文章抓取等。
限制与注意事项
- 大部分参数需要传字符串（如 "0" 而非 0）。
- 每次成功调用都会计费，避免不必要的重复请求；响应中有 cache_url 可免费重复访问（24h 有效）。
- 批量抓取时建议按 ID 去重，并设置连续 N 页无新数据则停止的安全机制。
- Windows 内联 Python 处理中文/emoji 时需注意编码，tikhub_client.py 已内置处理。
- 抖音用户搜索返回的用户信息嵌套在 dynamic_patch.raw_data（JSON 字符串）中，必须用 parse_user_search_results() 解析；视频下载链接字段不统一，用 extract_video_url() 统一处理。
- 小红书 Web 接口分页重复严重（约 60%），获取全部笔记必须用 App 接口。
- B站搜索结果混合多个 UP 主，需按 author 和 mid 过滤；UID 有长 UID 与旧版短 mid 两种格式。
- 微信公众号无法按名称搜索，搜狗微信反爬严重，最可靠方式是用户手动提供一篇文章链接。
- 跨平台兼容：macOS/Linux 使用 python3，Windows 使用 python；Skill 路径分别为 ~/.claude/skills/social-media-scout/ 与 %USERPROFILE%.claude\skills\social-media-scout\。
- TikHub 文档：https://docs.tikhub.io；API Key 管理：https://user.tikhub.io。