SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场shengjiang-research

shengjiang-research

营销与增长

查看项目

更新于 10-15 17:10

技能介绍

用途

生姜调研把“搜几条内容看看”变成一套 API-first 的全平台社媒调研流程：先查端点和价格，再跑小样本，最后批量采集账号、作品、评论、字幕和公开数据，并沉淀为能回指原始证据的结构化资产。适用于全平台调研、博主调研、对标账号、关键词/话题调研，以及已有 Excel、CSV、JSON 的清洗、去重、字段统一和洞察分析。

主要能力

  • 通过 TikHub 的账号、作品、搜索、评论、字幕、直播或电商等端点采集用户有权访问的公开社媒数据。
  • 处理用户已有的 Excel、CSV、JSON、链接清单和截图。
  • 输出账号表、作品表、评论表、逐字稿、证据索引和选题/对标分析。
  • 视频下载与逐字稿快捷模式：用户给出公开视频链接并要求下载、转写、提取原文时，运行 scripts/video_download_transcribe.py，先 dry-run 显示平台、端点和请求数再执行；批量输入使用 --links-file。
  • TikHub 当前覆盖 TikTok、Douyin、Red Note / Xiaohongshu、Instagram、Twitter / X、YouTube、Threads、LinkedIn、Reddit、Bilibili、Weibo、Lemon8、Kuaishou、WeChat、Zhihu 等平台，具体能力以当次 OpenAPI 和小样本为准。

使用方式

  1. 定义调研任务：确认平台、账号/链接/关键词、时间范围与样本量、字段、交付物、是否允许付费调用、输出目录。
  2. 查端点：端点不确定时查询 TikHub OpenAPI 描述，记录请求方法、单价、每页数据量和限制。
  3. 拆请求数并估价：按实际端点拆算，先用脚本离线预览，已配置 Key 时优先调用 TikHub 官方价格计算接口。
  4. 小样本验证：先 dry-run 确认不泄露 Key，再执行 1–3 条真实样本，通过后再批量。
  5. 按成本顺序采集：账号资料、作品元数据、评论、媒体、字幕。
  6. 保存原始证据：推荐目录 social-research/ 下分 raw、normalized、media、transcripts、evidence、reports。
  7. 分析与交付：账号样本表、作品明细、评论聚类、标题钩子拆解、可执行选题或对标清单，并记录请求次数、费用、限制和待补采项。

配置方面，第一次使用前完整读取 references/configuration.md 和 references/paid-api-route.md；执行视频下载或逐字稿任务时再读取 references/video-download-transcribe.md。默认用 --configure-local-key 将 Key 保存到 scripts/.tikhub_api_key，文件优先于环境变量。

适用场景

  • 全平台调研、博主调研、对标账号、关键词/话题调研。
  • 拉取近 N 条作品、抓评论区、下载公开媒体、取字幕或做逐字稿。
  • 抖音、小红书、视频号、TikTok、YouTube、B站、快手、微博、Instagram、X、Reddit、知乎等公开数据。
  • 已有 Excel / CSV / JSON 的清洗、去重、字段统一和洞察分析。

不默认使用本技能的场景：微信公众号文章正文导出（优先使用用户当前可用的公众号导出工具）、本机微信聊天/群/朋友圈本地数据、普通网页与官网博客、只写口播稿或内容成稿。

限制

  • 技能采用 MIT 协议免费开源，但数据接口不免费：自动采集使用第三方 TikHub API，用户需自行注册、充值或使用试用额度。TikHub 是作者基于真实使用体验的主动推荐，不代表官方合作、授权或商务背书，也不是自建、代理或转售的接口。
  • 价格、免费额度、端点和阶梯折扣会变化，执行时以 TikHub 官方价格页、端点文档和价格计算 API 为准；只能写“预估”，不能承诺固定费用。
  • 逐字稿优先使用平台官方字幕或作者提供的文本；没有可靠字幕时只能调用用户自行配置的第三方 ASR API；禁止使用 Whisper、faster-whisper、MLX Whisper 或其他本地语音模型做临时转写或失败兜底。第三方 ASR 不可用时保留媒体和元数据，标记“待第三方 API 转写”。
  • 不预置真实 API Key、免费数据源、Cookie 或平台登录态；不绕过登录、验证码、付费、访问控制或平台限制；不自动登录创作者后台抓取非公开数据；不把免费开源 Skill 说成免费 API。
  • 只采集用户有权访问且符合平台规则的公开数据，不收集密码、Cookie、会话令牌、支付信息或无关个人信息，最终交付不暴露可复用凭据。
  • 没有明确项目归属时，不得把抓取结果默认写进知识库根目录、00.收件箱/、output/ 或 outputs/，只在系统临时目录跑小样本。

错误处理要点

没有 Key 时先检查已保存文件、配置和兼容来源；401 表示 Key 无效、过期或请求头不正确；402 表示余额或额度不足；429 表示触发频率限制，需降低并发、缩小范围或延迟重试；火山 ASR 出现 audio_duration_lifetime 时，若 Cluster 以 _flash 结尾，改用对应标准 Cluster 重试一次，不重新下载媒体、不重建音频、不改用本地模型，也不把单个资源错误扩大成账号整体没额度；成功但无数据时核对目标、地区、权限、时间范围和分页参数；字段漂移时保留原始响应、更新映射、不改写原始数据；成本超预估时立即暂停并重新给出请求与费用预览。