用途:通过红狐数据API查询抖音账号基础信息与近期作品数据,适用于竞品监测、达人评估、内容优化和数据分析等场景,也支持在Coze、Dify等平台作为对话技能调用。
主要能力:查询账号昵称、抖音号、UID、粉丝数、作品总数等基础信息;获取近期作品列表(最多50条/页,按发布时间倒序),包含标题、发布时间、点赞、评论、分享、收藏及作品链接,互动数需手动按点赞+评论+分享+收藏计算;自动输出互动量TOP3作品分析和账号特征分析(更新频率、内容方向、互动表现、爆款特征);支持Markdown和JSON两种输出格式。
使用方式:需Python 3.6+和红狐数据API密钥(格式ak_xxx)。先配置环境变量:macOS/Linux使用export REDFOX_API_KEY=你的API密钥值,Windows PowerShell使用$env:REDFOX_API_KEY="你的API密钥值"。然后运行:python scripts/douyin_works_fetcher.py --account "抖音名称或抖音号",可用--output json导出结构化数据。数据源接口为POST https://redfox.hk/story/api/dy/data/listWorkByAccount,认证使用X-API-KEY请求头,按调用次数计费消耗积分。
限制:中文昵称非唯一标识且广域库收录率低,检测到中文输入会直接阻断并引导用户提供抖音号(纯字母、字母+数字或纯数字);查询未命中和API调用失败时严禁联网搜索或从第三方渠道补充估算;广域库仅收录热门数据,部分账号可能查不到;默认超时30秒;具体接口规范、输出模板和处理规则需遵循references/core_workflow.md。红狐API密钥获取、积分充值等费用细节暂未提供具体价格信息。