{"id":"c2444423-3082-4871-9da3-5081113379b9","entityType":"agent","slug":"clawhub-redfox-data-douyin-works-crawler","name":"抖音作品爬取","canonicalUrl":"https://www.xpersona.co/agent/clawhub-redfox-data-douyin-works-crawler","canonicalPath":"/agent/clawhub-redfox-data-douyin-works-crawler","generatedAt":"2026-10-11T17:43:05.133Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T14:58:17.168Z","emptyReason":null},"description":"抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。 Skill: 抖音作品爬取 Owner: redfox-data Summary: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-08-06T02:30:59.109Z | auto - Removed账号收录相关功能及说明，精简功能范围，仅保留账号信息与近期作品爬取（最多50条）。 - 相应删除命令速查与文档中涉及账号收录的命令与流程。 - 更新和简化项目说明文档，包括安装、使用指南和常见问答，移除收录相关内容与说明。 - 删除 skill-card.md 文件，不再包含该描述文件。 - 保持主程序及接口调用说明一致，仅保留基础信息获取与内容采集功能。 v1.0.2 | 2","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:douyin-works-crawler","sourceUrl":"https://clawhub.ai/redfox-data/douyin-works-crawler","homepage":"https://clawhub.ai/redfox-data/skills/douyin-works-crawler","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/redfox-data/douyin-works-crawler","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/redfox-data/skills/douyin-works-crawler","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。 Skill: 抖音作品爬取 Owner: redfox-data Summary: 抖音作品爬取工具，输入抖音名称或"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:58:17.168Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:58:17.168Z","emptyReason":null},"stars":null,"forks":null,"downloads":1045,"packageName":null,"latestVersion":"1.0.3","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:58:17.155Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T14:58:17.168Z","lastCrawledAt":"2026-10-11T14:58:17.155Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T14:58:17.155Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.3","createdAt":"2026-08-06T02:30:59.109Z","changelog":"- Removed账号收录相关功能及说明，精简功能范围，仅保留账号信息与近期作品爬取（最多50条）。 - 相应删除命令速查与文档中涉及账号收录的命令与流程。 - 更新和简化项目说明文档，包括安装、使用指南和常见问答，移除收录相关内容与说明。 - 删除 skill-card.md 文件，不再包含该描述文件。 - 保持主程序及接口调用说明一致，仅保留基础信息获取与内容采集功能。","fileCount":7,"zipByteSize":18731},{"version":"1.0.2","createdAt":"2026-07-21T09:42:22.331Z","changelog":"# douyin-works-crawler 1.0.2 Changelog - Removed the file `skill-card.md` from the project. - No other functional or documentation changes.","fileCount":7,"zipByteSize":20491},{"version":"1.0.1","createdAt":"2026-06-11T02:53:15.164Z","changelog":"- Removed the file skill-card.md. - No changes to code or features; only documentation cleanup.","fileCount":7,"zipByteSize":20148},{"version":"1.0.0","createdAt":"2026-06-10T08:47:47.639Z","changelog":"douyin-works-crawler 1.0.0 - 首发版本上线 - 支持输入抖音名称或ID，获取账号基础信息与最多50条近期作品内容 - 输出作品互动数据及作品链接 - 面向内容分析、品牌方、MCN机构与自媒体用户 - 提供简单命令行工具和API集成方式","fileCount":7,"zipByteSize":20107}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:douyin-works-crawler","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T17:43:05.130Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-works-crawler/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T14:58:17.168Z","emptyReason":null},"readme":"Skill: 抖音作品爬取\n\nOwner: redfox-data\n\nSummary: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。\n\nTags: latest:1.0.3\n\nVersion history:\n\nv1.0.3 | 2026-08-06T02:30:59.109Z | auto\n\n- Removed账号收录相关功能及说明，精简功能范围，仅保留账号信息与近期作品爬取（最多50条）。\n- 相应删除命令速查与文档中涉及账号收录的命令与流程。\n- 更新和简化项目说明文档，包括安装、使用指南和常见问答，移除收录相关内容与说明。\n- 删除 skill-card.md 文件，不再包含该描述文件。\n- 保持主程序及接口调用说明一致，仅保留基础信息获取与内容采集功能。\n\nv1.0.2 | 2026-07-21T09:42:22.331Z | user\n\n# douyin-works-crawler 1.0.2 Changelog\n\n- Removed the file `skill-card.md` from the project.\n- No other functional or documentation changes.\n\nv1.0.1 | 2026-06-11T02:53:15.164Z | user\n\n- Removed the file skill-card.md.  \n- No changes to code or features; only documentation cleanup.\n\nv1.0.0 | 2026-06-10T08:47:47.639Z | auto\n\ndouyin-works-crawler 1.0.0\n\n- 首发版本上线\n- 支持输入抖音名称或ID，获取账号基础信息与最多50条近期作品内容\n- 输出作品互动数据及作品链接\n- 面向内容分析、品牌方、MCN机构与自媒体用户\n- 提供简单命令行工具和API集成方式\n\nArchive index:\n\nArchive v1.0.3: 7 files, 18731 bytes\n\nFiles: README.en.md (5528b), README.md (5122b), references/core_workflow.md (6816b), scripts/douyin_works_fetcher.py (17831b), skill-card.md (2345b), SKILL.md (8114b), _meta.json (139b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: douyin-works-crawler\r\ndescription: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。\r\n---\r\n\r\n# 抖音作品爬取\r\n\r\n> 输入抖音名称或ID，一键获取账号基础信息 + 近期作品内容\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品爬取是一款专为抖音内容分析打造的智能工具，帮助用户快速获取任意抖音账号的基础信息和近期作品数据。\r\n\r\n通过简单的账号名称或抖音号输入，你可以：\r\n- 📊 获取账号基础信息（粉丝数、获赞、作品总数、红狐指数等）\r\n- 📋 查看近期作品列表（最多50条，含互动数据和作品链接）\r\n- 🔍 发现互动TOP3作品，获取值得学习的内容分析\r\n\r\n适用于品牌方、MCN机构、内容运营、自媒体从业者等需要分析抖音账号表现的场景。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）\r\n- **📋 近期作品爬取**：自动获取近期作品列表（最多50条），包含点赞、评论、分享、互动数及作品链接\r\n- **🔍 数据亮点分析**：互动量TOP3作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 智能识别**：自动判断输入类型（昵称/抖音号），无需手动切换查询模式\r\n- **🔗 直达链接**：昵称跳转账号主页，作品列表跳转视频页面\r\n- **🔒 安全可靠**：API 接入方式，无需登录抖音账号\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.6+\r\n- 红狐数据API密钥（格式 `ak_xxx`）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：直接使用（推荐）\r\n\r\n1. 确保项目文件已下载到本地\r\n2. 配置环境变量：\r\n   ```bash\r\n   # macOS/Linux\r\n   export REDFOX_API_KEY=你的API密钥值\r\n\r\n   # Windows PowerShell\r\n   $env:REDFOX_API_KEY=\"你的API密钥值\"\r\n   ```\r\n3. 运行查询：\r\n   ```bash\r\n   python scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n   ```\r\n\r\n#### 方式二：在 Coze/Dify 等平台配置\r\n\r\n1. 将技能文件夹上传至平台\r\n2. 在环境变量中配置 `REDFOX_API_KEY`\r\n3. 配置触发词，即可通过对话调用\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐数据API密钥（格式 `ak_xxx`） |\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查询账号作品\r\n\r\n告诉助手你想查询的抖音账号：\r\n\r\n> 用户：爬取\"周幺姑家常菜\"的抖音作品\r\n>\r\n> 助手：已为您查询到「周幺姑家常菜」的账号数据，粉丝547.1w，近期47条作品...\r\n\r\n#### 2. 精准查询（推荐）\r\n\r\n使用抖音号进行精准查询，避免昵称模糊匹配：\r\n\r\n> 用户：帮我查询抖音号 cdjjc028 的作品\r\n>\r\n> 助手：已精准匹配到「周幺姑家常菜」的账号数据...\r\n\r\n### 高级使用\r\n\r\n#### 4. 导出JSON格式\r\n\r\n需要结构化数据时，可指定JSON输出：\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"抖音号\" --output json\r\n```\r\n\r\n### 命令速查\r\n\r\n| 命令 | 功能 |\r\n|------|------|\r\n| `爬取抖音作品 [名称/抖音号]` | 查询账号作品数据 |\r\n| `抖音作品列表 [名称/抖音号]` | 获取近期作品列表 |\r\n| `抖音内容采集 [名称/抖音号]` | 采集账号内容 |\r\n| `导出抖音作品 [名称/抖音号]` | 导出作品数据 |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：品牌方竞品监测\r\n\r\n**角色**：品牌营销经理\r\n\r\n**需求**：监测竞品抖音账号的内容表现和互动数据\r\n\r\n**使用方式**：\r\n1. 输入竞品账号的抖音号进行查询\r\n2. 查看近期作品列表和互动数据\r\n3. 分析互动TOP3作品的内容特征\r\n\r\n**预期收益**：及时掌握竞品内容动态，优化自身内容策略\r\n\r\n---\r\n\r\n### 场景二：MCN 机构达人评估\r\n\r\n**角色**：MCN 运营人员\r\n\r\n**需求**：评估达人账号的数据表现和内容方向\r\n\r\n**使用方式**：\r\n1. 查询目标达人的账号基础信息（粉丝数、获赞、红狐指数）\r\n2. 分析近期作品的互动表现\r\n3. 查看账号特征分析，了解更新频率和内容方向\r\n\r\n**预期收益**：快速评估达人价值，辅助签约决策\r\n\r\n---\r\n\r\n### 场景三：自媒体内容优化\r\n\r\n**角色**：抖音内容创作者\r\n\r\n**需求**：学习同领域头部账号的爆款内容特征\r\n\r\n**使用方式**：\r\n1. 查询同领域头部账号的作品数据\r\n2. 查看互动TOP3作品的分析\r\n3. 学习爆款内容值得借鉴的点\r\n\r\n**预期收益**：找到内容优化方向，提升账号互动表现\r\n\r\n---\r\n\r\n### 场景四：数据分析报告\r\n\r\n**角色**：数据分析师\r\n\r\n**需求**：批量获取抖音账号的结构化数据用于分析\r\n\r\n**使用方式**：\r\n1. 使用 `--output json` 参数导出结构化数据\r\n2. 批量查询多个账号\r\n3. 结合其他数据进行综合分析\r\n\r\n**预期收益**：高效获取数据，支撑分析报告输出\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\ndouyin-works-crawler/\r\n├── scripts/\r\n│   └── douyin_works_fetcher.py   # 核心脚本（API调用+数据格式化）\r\n├── references/\r\n│   └── core_workflow.md          # 核心技能逻辑（接口规范、输出模板、处理规则）\r\n├── CONFIG.json                   # 技能配置文件\r\n└── SKILL.md                      # 技能说明文档\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.6+ |\r\n| 数据来源 | 红狐数据API |\r\n| 认证方式 | API Key（X-API-KEY请求头） |\r\n| 输出格式 | Markdown / JSON |\r\n\r\n\r\n### 核心模块说明\r\n\r\n- **DouyinWorksFetcher**：核心类，封装查询和数据格式化两大功能\r\n  - `query_account()`：查询账号信息和作品列表\r\n  - `format_markdown()` / `format_json()`：输出格式化\r\n\r\n> 📌 **完整的接口规范、输出模板、处理规则等核心逻辑详见 [references/core_workflow.md](references/core_workflow.md)**，Agent 执行时必须遵循该文件中的所有规则。\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1: 运行时提示\"未设置环境变量 REDFOX_API_KEY\"怎么办？**\r\n\r\nA: 请先配置环境变量：\r\n```bash\r\n# macOS/Linux\r\nexport REDFOX_API_KEY=你的API密钥值\r\n\r\n# Windows PowerShell\r\n$env:REDFOX_API_KEY=\"你的API密钥值\"\r\n```\r\n\r\n**Q2: 红狐数据API密钥如何获取？**\r\n\r\nA: 前往红狐平台注册并申请API密钥，格式为 `ak_xxx`。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q3: 用昵称查询返回的不是我要找的账号怎么办？**\r\n\r\nA: 抖音昵称不唯一，建议使用抖音号进行精准查询。抖音号在抖音APP → 目标账号主页 → 昵称下方查看。\r\n\r\n**Q4: 为什么有些账号查不到？**\r\n\r\nA: 可能该账号暂无数据记录，建议使用抖音号进行精准查询，或稍后再试。\r\n\r\n**Q5: 作品列表最多显示多少条？**\r\n\r\nA: 近期作品数据最多50条，按发布时间倒序排列。`awemeCount` 字段为账号历史作品总数，作品列表中的数量可能小于该值。\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q6: API调用报错\"积分不足\"怎么办？**\r\n\r\nA: 红狐API按调用次数计费，请前往红狐平台充值积分。\r\n\r\n**Q7: 查询超时怎么办？**\r\n\r\nA: 请检查网络连接是否正常，脚本默认超时时间为30秒。如持续超时，可稍后重试。\r\n\r\n---\r\n\r\n### 版本信息\r\n\r\n- **当前版本：** v2.3\r\n- **v2.2更新：** 数字格式规范（万→w，≥1亿用亿，<1万千分位）；链接列格式固定为`[链接](url)`/`-`\r\n- **v2.1更新：** 接口新增url字段，支持作品直达链接输出\r\n- **v2.0更新：** 切换至 `/dyData/queryUserWithWorks` 接口，支持近期作品数据爬取\r\n- **v1.0更新：** 初始版本\n\nFile v1.0.3:README.md\n\n# 抖音作品爬取 / douyin-works-crawler\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品数据获取工具，输入抖音昵称或抖音号，一键获取账号基础信息与近期作品内容列表（最多 50 条），含互动数据和作品直达链接，并提供互动 TOP3 分析与账号特征总结，帮助用户快速掌握目标账号的内容表现。\r\n\r\n**核心价值**\r\n\r\n- **一键获取作品数据**：输入昵称或抖音号，自动获取账号粉丝数、获赞、作品总数等基础信息及近期作品列表。\r\n- **数据亮点自动分析**：互动量 TOP3 作品分析 + 账号特征总结（更新频率、内容方向、互动表现、爆款特征），快速发现值得学习的内容。\r\n- **作品直达链接**：每条作品提供直达链接，点击即可跳转查看原视频。\r\n\r\n**适用对象**\r\n\r\n- 🏢 **品牌方 / 营销经理** — 监测竞品抖音账号的内容表现和互动数据。\r\n- 🛍️ **MCN / 运营人员** — 快速评估达人账号的数据表现和内容方向。\r\n- 📝 **抖音内容创作者** — 学习同领域头部账号的爆款内容特征。\r\n- 📊 **数据分析师** — 批量获取结构化数据用于分析报告。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）。\r\n- **近期作品获取**：自动获取近期作品列表（最多 50 条），包含点赞、评论、分享、互动数及作品直达链接。\r\n- **数据亮点分析**：输出互动量 TOP3 作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）。\r\n\r\n### 特色亮点\r\n\r\n- **智能识别**：自动判断输入类型（昵称/抖音号），含中文走昵称查询，非中文走抖音号精准查询。\r\n- **直达链接**：昵称可跳转账号主页，每条作品提供直达链接。\r\n- **安全可靠**：通过数据服务接入，无需登录抖音账号。\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=clawhub) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述查询需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图 | 示例话术 | 效果 |\r\n| ---- | -------- | ---- |\r\n| 查询账号作品 | 「爬取周幺姑家常菜的抖音作品」 | 获取账号基础信息 + 近期作品列表 + 数据亮点分析 |\r\n| 精准查询 | 「帮我查询抖音号 cdjjc028 的作品」 | 按抖音号精准匹配，避免昵称模糊 |\r\n| 导出数据 | 「导出周幺姑家常菜的作品数据」 | 获取结构化作品数据 |\r\n\r\n### 输出示例\r\n\r\n完成查询后，你将收到以下结构化的结果：\r\n\r\n**账号基础信息**：昵称（可点击跳转主页）、抖音号、地域、粉丝数、获赞、作品总数、红狐指数\r\n\r\n**近期作品列表**（最多 50 条，按发布时间倒序）：\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n| … | … | … | … | … | … | … | 可点击跳转原视频 |\r\n\r\n**数据亮点**：互动量 TOP3 作品分析 + 账号特征（更新频率、内容方向、互动表现、爆款特征）\r\n\r\n---\r\n\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ---- | ---- | -------- | ---- |\r\n| 品牌竞品监测 | 品牌营销经理 | 「帮我查一下竞品抖音号的作品数据和互动表现」 | 及时掌握竞品内容动态，优化自身策略 |\r\n| MCN 达人评估 | MCN 运营人员 | 「帮我看看这个达人的粉丝数、获赞和近期作品数据」 | 快速评估达人价值，辅助签约决策 |\r\n| 内容优化学习 | 抖音创作者 | 「帮我查同领域头部账号的作品，分析爆款特征」 | 找到内容优化方向，提升账号互动表现 |\r\n| 数据分析报告 | 数据分析师 | 「帮我导出这几个抖音号的作品数据做分析」 | 高效获取结构化数据，支撑分析报告 |\r\n\r\n---\r\n\r\n## 重要数据说明\r\n\r\n- 作品列表为近期作品数据，最多 50 条，按发布时间倒序排列，非账号全部历史作品。\r\n- 数字格式：≥1 万显示为 `x.xw`（如 3.2w），≥1 亿显示为 `x.x亿`，<1 万用千分位逗号。\r\n- 抖音昵称不唯一，用昵称查询可能返回模糊匹配结果，建议用抖音号进行精准查询。\r\n- 所有数据唯一来源为数据平台，不会从第三方渠道补充或估算。\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n\r\n---\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n  \"slug\": \"douyin-works-crawler\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1785983459109\n}\n\nFile v1.0.3:references/core_workflow.md\n\n# 核心技能逻辑\r\n\r\n> 本文件为 douyin-works-crawler 技能的完整执行逻辑参考，SKILL.md 通过引用本文件获取详细规则。\r\n\r\n---\r\n\r\n## 1. 数据来源\r\n\r\n**唯一数据源：红狐数据API**\r\n\r\n### 1.1 查询接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/story/api/dyData/queryUserWithWorks` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/story/api/dyData/queryUserWithWorks`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 否* | 抖音号/uid（支持 unique_id、short_id、uid 任一匹配） |\r\n| `accountName` | String | 否* | 作者/账号名 |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n> *accountId和accountName至少传一个\r\n\r\n> **查询精准度提醒：** 抖音昵称不唯一，使用accountName可能返回首个模糊匹配账号。若需精准查询，建议使用accountId（抖音号）。\r\n\r\n**响应字段：**\r\n\r\n- 账号级：nickname / accountId / uniqueId / uid / secUid / province / city / ipLocation / followerCount / awemeCount / totalFavorited / redfoxIndex\r\n- 作品级（workList，近期作品数据，最多50条，按发布时间倒序）：title / likeCount / commentCount / shareCount / interactiveCount / publishTime / url\r\n\r\n**数据范围说明：**\r\n\r\n- API返回的 `workList` 为**近期作品数据，最多50条**，按发布时间倒序排列\r\n- 实际返回数量取决于账号发布频率，通常为 1~50 条\r\n- `awemeCount` 字段为账号历史作品**总数**，workList中的数量可能小于该值\r\n- 若账号近期无作品或暂无数据，workList 为空列表\r\n\r\n\r\n## 2. 查询未命中处理\r\n\r\n当查询未找到目标账号时，**严禁联网搜索**，按以下流程处理：\r\n\r\n1. **匹配到错误账号** → 提示：\"昵称查询返回的是「[实际匹配的昵称]」，非您要找的账号。请提供目标账号的**抖音号**进行精准查询。\"\r\n2. **未查询到账号** → 输出提示信息：\r\n\r\n```\r\n未查询到当前账号的相关信息，请检查输入的抖音号或昵称是否正确。\r\n建议使用抖音号进行精准查询，或稍后再试。\r\n```\r\n\r\n### 降级策略\r\n\r\nAPI调用失败（如积分不足、网络异常）时明确告知用户错误原因，**严禁联网搜索、严禁从第三方渠道估算或补充API未返回的字段**。\r\n\r\n---\r\n\r\n## 3. 输出模板\r\n\r\n**使用说明：** 严格按模板输出，不可省略章节。数据来源于API，如实展示。\r\n\r\n**数字格式规范：** ≥1万用 `w`（如 3.2w），≥1亿用 `亿`（如 1.5亿），<1万用千分位逗号（如 8,642）。\r\n\r\n**链接列格式：** 有url时显示 `[链接](url)`，无url时显示 `-`。\r\n\r\n**昵称链接格式：** 昵称字段使用 `[nickname](https://www.douyin.com/user/{secUid})` 格式，secUid 为空时显示纯文本。\r\n\r\n```markdown\r\n## 🎬 [nickname] - 抖音作品数据\r\n\r\n### 账号基础信息\r\n\r\n| 昵称 | 抖音号 | UID | 地域 | 粉丝数 | 获赞 | 作品总数 | 红狐指数 |\r\n|------|--------|-----|------|--------|------|---------|---------|\r\n| [nickname](https://www.douyin.com/user/[secUid]) | [accountId] | [uid] | [province·city] | [followerCount] | [totalFavorited] | [awemeCount] | [redfoxIndex] |\r\n\r\n---\r\n\r\n### 近期作品（共[N]条）\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n|---|---------|------|------|------|------|------|------|\r\n| 1 | [publishTime] | [title] | [likeCount] | [commentCount] | [shareCount] | [interactiveCount] | [链接](url) / - |\r\n\r\n> 作品列表为近期作品数据，最多50条（按发布时间倒序），账号历史作品总数为 [awemeCount] 条。\r\n\r\n---\r\n\r\n### 数据亮点\r\n\r\n#### 互动量TOP3\r\n\r\n🥇 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥈 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥉 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n\r\n#### 账号特征分析\r\n\r\n- **更新频率：** [基于近期作品发布间隔分析]\r\n- **内容方向：** [基于作品标题关键词归纳内容赛道]\r\n- **互动表现：** [基于互动数据整体趋势分析]\r\n- **爆款特征：** [基于TOP3作品共性总结]\r\n\r\n---\r\n\r\n### 数据说明\r\n\r\n- **数据范围：** 近期作品数据，最多50条，按发布时间倒序\r\n- **作品链接：** 接口返回url字段，提供作品直达链接；url为空时显示\"-\"\r\n- **数字格式：** ≥1万显示为x.xw（如3.2w），≥1亿显示为x.x亿，<1万用千分位逗号\r\n- **数据来源：** 红狐数据API\r\n\r\n*爬取时间：[YYYY-MM-DD HH:mm]*\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n```\r\n\r\n---\r\n\r\n## 4. 脚本调用\r\n\r\n> ⚠️ **单次调用原则：** 每次查询仅执行一次脚本调用，使用默认的 `markdown` 输出即可获得完整格式化报告，**禁止重复调用（如先json再markdown）以避免浪费API积分**。\r\n\r\n**查询账号作品：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n```\r\n\r\n\r\n**参数说明：**\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--account` | 抖音昵称或抖音号（自动识别：含中文→昵称，非中文→抖音号） |\r\n| `--output` | 输出格式：`markdown`（默认）/ `json` |\r\n\r\n**自动识别逻辑：**\r\n- 输入含中文 → 使用 `accountName` 参数查询（昵称模糊匹配）\r\n- 输入非中文 → 使用 `accountId` 参数查询（抖音号精准匹配）\r\n\r\n---\r\n\r\n## 5. 注意事项\r\n\r\n- 🔌 **唯一数据源：** 所有数据仅从红狐API获取，不使用第三方渠道补充或估算\r\n- 📊 **数据范围：** 近期作品数据，最多50条，非账号全部历史作品\r\n- 🔢 **数字格式：** ≥1万显示为 `x.xw`（如3.2w），≥1亿显示为 `x.x亿`，<1万用千分位逗号（如8,642）\r\n- 🔗 **作品链接：** 接口返回url字段，表格中显示为 `[链接](url)`，无url时显示 `-`\r\n- ❌ **未查询到账号：** API返回空数据时，输出提示信息引导用户使用抖音号精准查询，**严禁联网搜索、严禁生成无依据报告**\r\n- ❌ **昵称匹配到错误账号：** 提示用户当前匹配结果非目标账号，引导提供抖音号重新查询，**严禁联网搜索**\r\n- ✅ **如实输出：** 作品数量如实展示\n\nFile v1.0.3:README.en.md\n\n# Douyin Works Crawler / douyin-works-crawler\r\n\r\n---\r\n\r\n## Overview\r\n\r\nA Douyin content data retrieval tool. Enter a Douyin nickname or ID to instantly fetch account basic info and recent works (up to 50 items), including engagement data and direct video links—plus a TOP 3 engagement analysis and account feature summary to help you quickly understand the target account's content performance.\r\n\r\n**Core Value**\r\n\r\n- **One-click works retrieval**: Enter a nickname or Douyin ID to automatically fetch account basic info (followers, total likes, total works, RedFox Index) and recent work lists.\r\n- **Auto data highlight analysis**: TOP 3 engagement works analysis + account feature summary (posting frequency, content direction, engagement trends, viral patterns)—quickly identify content worth learning from.\r\n- **Direct work links**: Each work comes with a direct link—click to jump to the original video.\r\n\r\n**Intended Users**\r\n\r\n- 🏢 **Brands / marketing managers** — Monitor competitor Douyin account content performance and engagement data.\r\n- 🛍️ **MCN / operations staff** — Quickly evaluate creator account data performance and content direction.\r\n- 📝 **Douyin content creators** — Learn viral content patterns from top accounts in your niche.\r\n- 📊 **Data analysts** — Batch-fetch structured data for analysis reports.\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Account info query**: Enter a Douyin nickname or ID to instantly fetch account basic data (followers, total likes, total works, RedFox Index, etc.).\r\n- **Recent works retrieval**: Automatically fetch recent works (up to 50 items), including likes, comments, shares, engagement counts, and direct work links.\r\n- **Data highlight analysis**: Output TOP 3 engagement works analysis + account feature analysis (posting frequency, engagement trends, viral patterns).\r\n\r\n### Highlights\r\n\r\n- **Smart recognition**: Automatically detects input type (nickname/ID)—Chinese input uses nickname search, non-Chinese uses precise ID search.\r\n- **Direct links**: Nickname links to account homepage; each work provides a direct video link.\r\n- **Safe & secure**: Data service-based access—no Douyin account login required.\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)\r\n- Register at [RedFoxHub](https://redfox.hk?source=clawhub) to obtain `REDFOX_API_KEY`.\r\n- Configure `REDFOX_API_KEY` on your device before using this skill.\r\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\r\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe your query needs in natural language—no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent | Example phrase | Result |\r\n| ------ | -------------- | ------ |\r\n| Query account works | \"Crawl Douyin works for 周幺姑家常菜\" | Fetch account basic info + recent work list + data highlight analysis |\r\n| Precise query | \"Query works for Douyin ID cdjjc028\" | Precise ID match, avoiding nickname ambiguity |\r\n| Export data | \"Export works data for 周幺姑家常菜\" | Get structured works data |\r\n\r\n### Output Example\r\n\r\nAfter querying, you will receive the following structured results:\r\n\r\n**Account Basic Info**: Nickname (clickable to homepage), Douyin ID, region, followers, total likes, total works, RedFox Index\r\n\r\n**Recent Works List** (up to 50 items, reverse chronological):\r\n\r\n| # | Publish Time | Title | Likes | Comments | Shares | Engagement | Link |\r\n| … | … | … | … | … | … | … | Clickable to original video |\r\n\r\n**Data Highlights**: TOP 3 engagement works analysis + Account features (posting frequency, content direction, engagement trends, viral patterns)\r\n\r\n---\r\n\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario | Role | Example question | Benefit |\r\n| -------- | ---- | ---------------- | ------- |\r\n| Brand competitor monitoring | Brand marketing manager | \"Check the works data and engagement of this competitor Douyin account for me\" | Stay on top of competitor content trends; optimize your own strategy |\r\n| MCN creator evaluation | MCN operations staff | \"Show me this creator's followers, likes, and recent works data\" | Quickly evaluate creator value; support signing decisions |\r\n| Content optimization learning | Douyin creator | \"Check the works of top accounts in my niche and analyze viral patterns\" | Find content optimization directions; boost account engagement |\r\n| Data analysis reports | Data analyst | \"Export works data for these Douyin accounts for analysis\" | Efficiently fetch structured data to support analysis reports |\r\n\r\n---\r\n\r\n## Important Data Notes\r\n\r\n- The work list shows recent works only—up to 50 items in reverse chronological order, not the account's full historical works.\r\n- Number formatting: ≥10k displays as `x.xw` (e.g., 3.2w), ≥100M displays as `x.x亿`; <10k uses comma separators.\r\n- Douyin nicknames are not unique; nickname queries may return fuzzy matches—use Douyin ID for precise lookup.\r\n- All data comes exclusively from the data platform; no third-party supplementation or estimation.\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n\r\n---\n\nFile v1.0.3:skill-card.md\n\n## Description:\n\nRetrieves Douyin account profile data and up to 50 recent works by nickname or Douyin ID, including engagement metrics, direct links, and a brief top-performing content analysis.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[redfox-data](https://clawhub.ai/user/redfox-data)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users such as brand marketers, MCN operators, Douyin creators, and data analysts use this skill to retrieve recent Douyin account works, compare engagement, and support content performance analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Douyin account identifiers to RedFox and returns collected account and work data.\n\nMitigation: Install only when that data transfer and downstream use are lawful, appropriate for the use case, and consistent with applicable platform terms.\n\nRisk: Security evidence reports that the script prints an API-key prefix, which can expose credential material in shared logs.\n\nMitigation: Avoid sharing execution logs and remove API-key prefix printing before deployment in shared or monitored environments.\n\nRisk: Security evidence reports an unrelated RedFox sales link in generated reports.\n\nMitigation: Review generated output before distribution and remove sales-link content when it is not appropriate for the audience.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/redfox-data/skills/douyin-works-crawler)\n- [Core workflow reference](references/core_workflow.md)\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)\n- [RedFoxHub](https://redfox.hk?source=clawhub)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, JSON, guidance]\n\n**Output Format:** [Markdown report or JSON object]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Reports include account fields, up to 50 recent works, engagement metrics, direct links when available, and TOP 3 engagement analysis.]\n\n## Skill Version(s):\n\n1.0.3 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.2: 7 files, 20491 bytes\n\nFiles: README.en.md (6152b), README.md (5673b), references/core_workflow.md (8581b), scripts/douyin_works_fetcher.py (20193b), skill-card.md (2398b), SKILL.md (9186b), _meta.json (139b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: douyin-works-crawler\r\ndescription: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。\r\n---\r\n\r\n# 抖音作品爬取\r\n\r\n> 输入抖音名称或ID，一键获取账号基础信息 + 近期作品内容\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品爬取是一款专为抖音内容分析打造的智能工具，帮助用户快速获取任意抖音账号的基础信息和近期作品数据。\r\n\r\n通过简单的账号名称或抖音号输入，你可以：\r\n- 📊 获取账号基础信息（粉丝数、获赞、作品总数、红狐指数等）\r\n- 📋 查看近期作品列表（最多50条，含互动数据和作品链接）\r\n- 🔍 发现互动TOP3作品，获取值得学习的内容分析\r\n- 📥 未收录账号支持一键提交收录，30分钟后自动同步\r\n\r\n适用于品牌方、MCN机构、内容运营、自媒体从业者等需要分析抖音账号表现的场景。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）\r\n- **📋 近期作品爬取**：自动获取近期作品列表（最多50条），包含点赞、评论、分享、互动数及作品链接\r\n- **🔍 数据亮点分析**：互动量TOP3作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 智能识别**：自动判断输入类型（昵称/抖音号），无需手动切换查询模式\r\n- **📥 账号收录**：未收录账号支持一键提交收录，30分钟后自动同步数据\r\n- **🔗 直达链接**：昵称跳转账号主页，作品列表跳转视频页面\r\n- **🔒 安全可靠**：API 接入方式，无需登录抖音账号\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.6+\r\n- 红狐数据API密钥（格式 `ak_xxx`）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：直接使用（推荐）\r\n\r\n1. 确保项目文件已下载到本地\r\n2. 配置环境变量：\r\n   ```bash\r\n   # macOS/Linux\r\n   export REDFOX_API_KEY=你的API密钥值\r\n\r\n   # Windows PowerShell\r\n   $env:REDFOX_API_KEY=\"你的API密钥值\"\r\n   ```\r\n3. 运行查询：\r\n   ```bash\r\n   python scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n   ```\r\n\r\n#### 方式二：在 Coze/Dify 等平台配置\r\n\r\n1. 将技能文件夹上传至平台\r\n2. 在环境变量中配置 `REDFOX_API_KEY`\r\n3. 配置触发词，即可通过对话调用\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐数据API密钥（格式 `ak_xxx`） |\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查询账号作品\r\n\r\n告诉助手你想查询的抖音账号：\r\n\r\n> 用户：爬取\"周幺姑家常菜\"的抖音作品\r\n>\r\n> 助手：已为您查询到「周幺姑家常菜」的账号数据，粉丝547.1w，近期47条作品...\r\n\r\n#### 2. 精准查询（推荐）\r\n\r\n使用抖音号进行精准查询，避免昵称模糊匹配：\r\n\r\n> 用户：帮我查询抖音号 cdjjc028 的作品\r\n>\r\n> 助手：已精准匹配到「周幺姑家常菜」的账号数据...\r\n\r\n#### 3. 账号收录\r\n\r\n当账号未被收录时，回复抖音号即可提交收录：\r\n\r\n> 用户：帮我查询\"xxx\"的作品\r\n>\r\n> 助手：未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。1. 回复抖音号...2. 下次再说；\r\n>\r\n> 用户：1212_1234\r\n>\r\n> 助手：已提交账号收录请求，系统正在同步数据，约30分钟后可再次查询。\r\n\r\n### 高级使用\r\n\r\n#### 4. 导出JSON格式\r\n\r\n需要结构化数据时，可指定JSON输出：\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"抖音号\" --output json\r\n```\r\n\r\n#### 5. 命令行直接提交收录\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"任意\" --sync \"抖音号\"\r\n```\r\n\r\n### 命令速查\r\n\r\n| 命令 | 功能 |\r\n|------|------|\r\n| `爬取抖音作品 [名称/抖音号]` | 查询账号作品数据 |\r\n| `抖音作品列表 [名称/抖音号]` | 获取近期作品列表 |\r\n| `抖音内容采集 [名称/抖音号]` | 采集账号内容 |\r\n| `导出抖音作品 [名称/抖音号]` | 导出作品数据 |\r\n| 回复抖音号 | 提交账号收录（未命中时） |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：品牌方竞品监测\r\n\r\n**角色**：品牌营销经理\r\n\r\n**需求**：监测竞品抖音账号的内容表现和互动数据\r\n\r\n**使用方式**：\r\n1. 输入竞品账号的抖音号进行查询\r\n2. 查看近期作品列表和互动数据\r\n3. 分析互动TOP3作品的内容特征\r\n\r\n**预期收益**：及时掌握竞品内容动态，优化自身内容策略\r\n\r\n---\r\n\r\n### 场景二：MCN 机构达人评估\r\n\r\n**角色**：MCN 运营人员\r\n\r\n**需求**：评估达人账号的数据表现和内容方向\r\n\r\n**使用方式**：\r\n1. 查询目标达人的账号基础信息（粉丝数、获赞、红狐指数）\r\n2. 分析近期作品的互动表现\r\n3. 查看账号特征分析，了解更新频率和内容方向\r\n\r\n**预期收益**：快速评估达人价值，辅助签约决策\r\n\r\n---\r\n\r\n### 场景三：自媒体内容优化\r\n\r\n**角色**：抖音内容创作者\r\n\r\n**需求**：学习同领域头部账号的爆款内容特征\r\n\r\n**使用方式**：\r\n1. 查询同领域头部账号的作品数据\r\n2. 查看互动TOP3作品的分析\r\n3. 学习爆款内容值得借鉴的点\r\n\r\n**预期收益**：找到内容优化方向，提升账号互动表现\r\n\r\n---\r\n\r\n### 场景四：数据分析报告\r\n\r\n**角色**：数据分析师\r\n\r\n**需求**：批量获取抖音账号的结构化数据用于分析\r\n\r\n**使用方式**：\r\n1. 使用 `--output json` 参数导出结构化数据\r\n2. 批量查询多个账号\r\n3. 结合其他数据进行综合分析\r\n\r\n**预期收益**：高效获取数据，支撑分析报告输出\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\ndouyin-works-crawler/\r\n├── scripts/\r\n│   └── douyin_works_fetcher.py   # 核心脚本（API调用+数据格式化）\r\n├── references/\r\n│   └── core_workflow.md          # 核心技能逻辑（接口规范、输出模板、处理规则）\r\n├── CONFIG.json                   # 技能配置文件\r\n└── SKILL.md                      # 技能说明文档\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.6+ |\r\n| 数据来源 | 红狐数据API |\r\n| 认证方式 | API Key（X-API-KEY请求头） |\r\n| 输出格式 | Markdown / JSON |\r\n\r\n\r\n### 核心模块说明\r\n\r\n- **DouyinWorksFetcher**：核心类，封装查询和收录两大功能\r\n  - `query_account()`：查询账号信息和作品列表\r\n  - `sync_account()`：提交账号收录请求\r\n  - `format_markdown()` / `format_json()`：输出格式化\r\n\r\n> 📌 **完整的接口规范、输出模板、处理规则等核心逻辑详见 [references/core_workflow.md](references/core_workflow.md)**，Agent 执行时必须遵循该文件中的所有规则。\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1: 运行时提示\"未设置环境变量 REDFOX_API_KEY\"怎么办？**\r\n\r\nA: 请先配置环境变量：\r\n```bash\r\n# macOS/Linux\r\nexport REDFOX_API_KEY=你的API密钥值\r\n\r\n# Windows PowerShell\r\n$env:REDFOX_API_KEY=\"你的API密钥值\"\r\n```\r\n\r\n**Q2: 红狐数据API密钥如何获取？**\r\n\r\nA: 前往红狐平台注册并申请API密钥，格式为 `ak_xxx`。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q3: 用昵称查询返回的不是我要找的账号怎么办？**\r\n\r\nA: 抖音昵称不唯一，建议使用抖音号进行精准查询。抖音号在抖音APP → 目标账号主页 → 昵称下方查看。\r\n\r\n**Q4: 为什么有些账号查不到？**\r\n\r\nA: 可能该账号尚未被红狐平台收录。查询未命中时会提示账号收录，回复抖音号即可提交收录，约30分钟后可再次查询。\r\n\r\n**Q5: 作品列表最多显示多少条？**\r\n\r\nA: 近期作品数据最多50条，按发布时间倒序排列。`awemeCount` 字段为账号历史作品总数，作品列表中的数量可能小于该值。\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q6: API调用报错\"积分不足\"怎么办？**\r\n\r\nA: 红狐API按调用次数计费，请前往红狐平台充值积分。\r\n\r\n**Q7: 查询超时怎么办？**\r\n\r\nA: 请检查网络连接是否正常，脚本默认超时时间为30秒。如持续超时，可稍后重试。\r\n\r\n---\r\n\r\n### 版本信息\r\n\r\n- **当前版本：** v2.3\r\n- **v2.3更新：** 新增账号收录功能；未查询到账号时输出收录提示；新增数据亮点模块（互动量TOP3+账号特征分析）；数据来源描述统一为\"红狐数据API\"\r\n- **v2.2更新：** 数字格式规范（万→w，≥1亿用亿，<1万千分位）；链接列格式固定为`[链接](url)`/`-`\r\n- **v2.1更新：** 接口新增url字段，支持作品直达链接输出\r\n- **v2.0更新：** 切换至 `/dyData/queryUserWithWorks` 接口，支持近期作品数据爬取\r\n- **v1.0更新：** 初始版本\n\nFile v1.0.2:README.md\n\n# 抖音作品爬取 / douyin-works-crawler\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品数据获取工具，输入抖音昵称或抖音号，一键获取账号基础信息与近期作品内容列表（最多 50 条），含互动数据和作品直达链接，并提供互动 TOP3 分析与账号特征总结，帮助用户快速掌握目标账号的内容表现。\r\n\r\n**核心价值**\r\n\r\n- **一键获取作品数据**：输入昵称或抖音号，自动获取账号粉丝数、获赞、作品总数等基础信息及近期作品列表。\r\n- **数据亮点自动分析**：互动量 TOP3 作品分析 + 账号特征总结（更新频率、内容方向、互动表现、爆款特征），快速发现值得学习的内容。\r\n- **作品直达链接**：每条作品提供直达链接，点击即可跳转查看原视频。\r\n- **未收录账号一键提交**：查询不到的账号，回复抖音号即可提交收录，约 30 分钟后自动同步数据。\r\n\r\n**适用对象**\r\n\r\n- 🏢 **品牌方 / 营销经理** — 监测竞品抖音账号的内容表现和互动数据。\r\n- 🛍️ **MCN / 运营人员** — 快速评估达人账号的数据表现和内容方向。\r\n- 📝 **抖音内容创作者** — 学习同领域头部账号的爆款内容特征。\r\n- 📊 **数据分析师** — 批量获取结构化数据用于分析报告。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）。\r\n- **近期作品获取**：自动获取近期作品列表（最多 50 条），包含点赞、评论、分享、互动数及作品直达链接。\r\n- **数据亮点分析**：输出互动量 TOP3 作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）。\r\n\r\n### 特色亮点\r\n\r\n- **智能识别**：自动判断输入类型（昵称/抖音号），含中文走昵称查询，非中文走抖音号精准查询。\r\n- **账号收录**：未收录账号支持一键提交收录，约 30 分钟后自动同步数据。\r\n- **直达链接**：昵称可跳转账号主页，每条作品提供直达链接。\r\n- **安全可靠**：通过数据服务接入，无需登录抖音账号。\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述查询需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图 | 示例话术 | 效果 |\r\n| ---- | -------- | ---- |\r\n| 查询账号作品 | 「爬取周幺姑家常菜的抖音作品」 | 获取账号基础信息 + 近期作品列表 + 数据亮点分析 |\r\n| 精准查询 | 「帮我查询抖音号 cdjjc028 的作品」 | 按抖音号精准匹配，避免昵称模糊 |\r\n| 提交账号收录 | 「我的号查不到，抖音号是 1212_1234」 | 提交收录请求，约 30 分钟后可再次查询 |\r\n| 导出数据 | 「导出周幺姑家常菜的作品数据」 | 获取结构化作品数据 |\r\n\r\n### 输出示例\r\n\r\n完成查询后，你将收到以下结构化的结果：\r\n\r\n**账号基础信息**：昵称（可点击跳转主页）、抖音号、地域、粉丝数、获赞、作品总数、红狐指数\r\n\r\n**近期作品列表**（最多 50 条，按发布时间倒序）：\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n| … | … | … | … | … | … | … | 可点击跳转原视频 |\r\n\r\n**数据亮点**：互动量 TOP3 作品分析 + 账号特征（更新频率、内容方向、互动表现、爆款特征）\r\n\r\n---\r\n\r\n（查询不到数据时，系统引导回复抖音号提交收录，30 分钟后自动同步。）\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ---- | ---- | -------- | ---- |\r\n| 品牌竞品监测 | 品牌营销经理 | 「帮我查一下竞品抖音号的作品数据和互动表现」 | 及时掌握竞品内容动态，优化自身策略 |\r\n| MCN 达人评估 | MCN 运营人员 | 「帮我看看这个达人的粉丝数、获赞和近期作品数据」 | 快速评估达人价值，辅助签约决策 |\r\n| 内容优化学习 | 抖音创作者 | 「帮我查同领域头部账号的作品，分析爆款特征」 | 找到内容优化方向，提升账号互动表现 |\r\n| 数据分析报告 | 数据分析师 | 「帮我导出这几个抖音号的作品数据做分析」 | 高效获取结构化数据，支撑分析报告 |\r\n\r\n---\r\n\r\n## 重要数据说明\r\n\r\n- 作品列表为近期作品数据，最多 50 条，按发布时间倒序排列，非账号全部历史作品。\r\n- 数字格式：≥1 万显示为 `x.xw`（如 3.2w），≥1 亿显示为 `x.x亿`，<1 万用千分位逗号。\r\n- 抖音昵称不唯一，用昵称查询可能返回模糊匹配结果，建议用抖音号进行精准查询。\r\n- 查询不到的账号支持提交收录，约 30 分钟后自动同步数据。\r\n- 所有数据唯一来源为数据平台，不会从第三方渠道补充或估算。\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n\r\n---\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n  \"slug\": \"douyin-works-crawler\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1784626942331\n}\n\nFile v1.0.2:references/core_workflow.md\n\n# 核心技能逻辑\r\n\r\n> 本文件为 douyin-works-crawler 技能的完整执行逻辑参考，SKILL.md 通过引用本文件获取详细规则。\r\n\r\n---\r\n\r\n## 1. 数据来源\r\n\r\n**唯一数据源：红狐数据API**\r\n\r\n### 1.1 查询接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/story/api/dyData/queryUserWithWorks` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/story/api/dyData/queryUserWithWorks`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 否* | 抖音号/uid（支持 unique_id、short_id、uid 任一匹配） |\r\n| `accountName` | String | 否* | 作者/账号名 |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n> *accountId和accountName至少传一个\r\n\r\n> **查询精准度提醒：** 抖音昵称不唯一，使用accountName可能返回首个模糊匹配账号。若需精准查询，建议使用accountId（抖音号）。\r\n\r\n**响应字段：**\r\n\r\n- 账号级：nickname / accountId / uniqueId / uid / secUid / province / city / ipLocation / followerCount / awemeCount / totalFavorited / redfoxIndex\r\n- 作品级（workList，近期作品数据，最多50条，按发布时间倒序）：title / likeCount / commentCount / shareCount / interactiveCount / publishTime / url\r\n\r\n**数据范围说明：**\r\n\r\n- API返回的 `workList` 为**近期作品数据，最多50条**，按发布时间倒序排列\r\n- 实际返回数量取决于账号发布频率，通常为 1~50 条\r\n- `awemeCount` 字段为账号历史作品**总数**，workList中的数量可能小于该值\r\n- 若账号近期无作品或作品未被收录，workList 为空列表\r\n\r\n### 1.2 账号收录接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/dyUser/syncUserNotes` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/dyUser/syncUserNotes`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 是 | 抖音账号ID（支持 unique_id、short_id、uid 任一匹配） |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n**响应说明：** 异步同步触发接口，调用成功返回 HTTP 200，无响应体。系统异步拉取账号文章/作品数据，约30分钟后可查询。\r\n\r\n**错误码：** 200=成功 | 400=参数错误 | 500=业务异常\r\n\r\n---\r\n\r\n## 2. 查询未命中处理\r\n\r\n当查询未找到目标账号时，**严禁联网搜索**，按以下流程处理：\r\n\r\n1. **匹配到错误账号** → 提示：\"昵称查询返回的是「[实际匹配的昵称]」，非您要找的账号。请提供目标账号的**抖音号**进行精准查询。\"\r\n2. **未查询到账号** → 输出账号收录提示，引导用户进行账号收录：\r\n\r\n```\r\n未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。\r\n1. 回复抖音号（在抖音个人主页显示的ID，如 1212_1234），即可进行账号收录。30分钟后将自动为您推作品查询报告~\r\n2. 下次再说；\r\n```\r\n\r\n3. **用户回复抖音号** → 调用账号收录接口 `POST /dyUser/syncUserNotes`，传入用户提供的抖音号作为 `accountId`，触发异步同步任务\r\n4. **用户选择\"下次再说\"** → 结束当前流程\r\n\r\n**收录成功后提示：** \"已提交账号收录请求，系统正在同步数据，约30分钟后可再次查询该账号的作品数据。\"\r\n\r\n**收录失败提示：** 根据错误码告知用户具体原因。\r\n\r\n### 降级策略\r\n\r\nAPI调用失败（如积分不足、网络异常）时明确告知用户错误原因，**严禁联网搜索、严禁从第三方渠道估算或补充API未返回的字段**。\r\n\r\n---\r\n\r\n## 3. 输出模板\r\n\r\n**使用说明：** 严格按模板输出，不可省略章节。数据来源于API，如实展示。\r\n\r\n**数字格式规范：** ≥1万用 `w`（如 3.2w），≥1亿用 `亿`（如 1.5亿），<1万用千分位逗号（如 8,642）。\r\n\r\n**链接列格式：** 有url时显示 `[链接](url)`，无url时显示 `-`。\r\n\r\n**昵称链接格式：** 昵称字段使用 `[nickname](https://www.douyin.com/user/{secUid})` 格式，secUid 为空时显示纯文本。\r\n\r\n```markdown\r\n## 🎬 [nickname] - 抖音作品数据\r\n\r\n### 账号基础信息\r\n\r\n| 昵称 | 抖音号 | UID | 地域 | 粉丝数 | 获赞 | 作品总数 | 红狐指数 |\r\n|------|--------|-----|------|--------|------|---------|---------|\r\n| [nickname](https://www.douyin.com/user/[secUid]) | [accountId] | [uid] | [province·city] | [followerCount] | [totalFavorited] | [awemeCount] | [redfoxIndex] |\r\n\r\n---\r\n\r\n### 近期作品（共[N]条）\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n|---|---------|------|------|------|------|------|------|\r\n| 1 | [publishTime] | [title] | [likeCount] | [commentCount] | [shareCount] | [interactiveCount] | [链接](url) / - |\r\n\r\n> 作品列表为近期作品数据，最多50条（按发布时间倒序），账号历史作品总数为 [awemeCount] 条。\r\n\r\n---\r\n\r\n### 数据亮点\r\n\r\n#### 互动量TOP3\r\n\r\n🥇 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥈 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥉 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n\r\n#### 账号特征分析\r\n\r\n- **更新频率：** [基于近期作品发布间隔分析]\r\n- **内容方向：** [基于作品标题关键词归纳内容赛道]\r\n- **互动表现：** [基于互动数据整体趋势分析]\r\n- **爆款特征：** [基于TOP3作品共性总结]\r\n\r\n---\r\n\r\n### 数据说明\r\n\r\n- **数据范围：** 近期作品数据，最多50条，按发布时间倒序\r\n- **作品链接：** 接口返回url字段，提供作品直达链接；url为空时显示\"-\"\r\n- **数字格式：** ≥1万显示为x.xw（如3.2w），≥1亿显示为x.x亿，<1万用千分位逗号\r\n- **数据来源：** 红狐数据API\r\n\r\n*爬取时间：[YYYY-MM-DD HH:mm]*\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n```\r\n\r\n---\r\n\r\n## 4. 脚本调用\r\n\r\n> ⚠️ **单次调用原则：** 每次查询仅执行一次脚本调用，使用默认的 `markdown` 输出即可获得完整格式化报告，**禁止重复调用（如先json再markdown）以避免浪费API积分**。\r\n\r\n**查询账号作品：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n```\r\n\r\n**提交账号收录：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"任意\" --sync \"抖音号\"\r\n```\r\n\r\n**参数说明：**\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--account` | 抖音昵称或抖音号（自动识别：含中文→昵称，非中文→抖音号） |\r\n| `--output` | 输出格式：`markdown`（默认）/ `json` |\r\n| `--sync` | 提交账号收录，传入抖音号触发异步同步 |\r\n\r\n**自动识别逻辑：**\r\n- 输入含中文 → 使用 `accountName` 参数查询（昵称模糊匹配）\r\n- 输入非中文 → 使用 `accountId` 参数查询（抖音号精准匹配）\r\n\r\n---\r\n\r\n## 5. 注意事项\r\n\r\n- 🔌 **唯一数据源：** 所有数据仅从红狐API获取，不使用第三方渠道补充或估算\r\n- 📊 **数据范围：** 近期作品数据，最多50条，非账号全部历史作品\r\n- 🔢 **数字格式：** ≥1万显示为 `x.xw`（如3.2w），≥1亿显示为 `x.x亿`，<1万用千分位逗号（如8,642）\r\n- 🔗 **作品链接：** 接口返回url字段，表格中显示为 `[链接](url)`，无url时显示 `-`\r\n- ❌ **未查询到账号：** API返回空数据时，输出账号收录提示文案，引导用户回复抖音号进行账号收录，**严禁联网搜索、严禁生成无依据报告**\r\n- 📥 **账号收录：** 用户回复抖音号后，调用 `POST /dyUser/syncUserNotes` 接口提交收录请求，约30分钟后可再次查询\r\n- ❌ **昵称匹配到错误账号：** 提示用户当前匹配结果非目标账号，引导提供抖音号重新查询，**严禁联网搜索**\r\n- ✅ **如实输出：** 作品数量如实展示\n\nFile v1.0.2:README.en.md\n\n# Douyin Works Crawler / douyin-works-crawler\r\n\r\n---\r\n\r\n## Overview\r\n\r\nA Douyin content data retrieval tool. Enter a Douyin nickname or ID to instantly fetch account basic info and recent works (up to 50 items), including engagement data and direct video links—plus a TOP 3 engagement analysis and account feature summary to help you quickly understand the target account's content performance.\r\n\r\n**Core Value**\r\n\r\n- **One-click works retrieval**: Enter a nickname or Douyin ID to automatically fetch account basic info (followers, total likes, total works, RedFox Index) and recent work lists.\r\n- **Auto data highlight analysis**: TOP 3 engagement works analysis + account feature summary (posting frequency, content direction, engagement trends, viral patterns)—quickly identify content worth learning from.\r\n- **Direct work links**: Each work comes with a direct link—click to jump to the original video.\r\n- **One-click unlisted account submission**: For accounts not yet indexed, reply with the Douyin ID to submit for indexing—data auto-syncs in about 30 minutes.\r\n\r\n**Intended Users**\r\n\r\n- 🏢 **Brands / marketing managers** — Monitor competitor Douyin account content performance and engagement data.\r\n- 🛍️ **MCN / operations staff** — Quickly evaluate creator account data performance and content direction.\r\n- 📝 **Douyin content creators** — Learn viral content patterns from top accounts in your niche.\r\n- 📊 **Data analysts** — Batch-fetch structured data for analysis reports.\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Account info query**: Enter a Douyin nickname or ID to instantly fetch account basic data (followers, total likes, total works, RedFox Index, etc.).\r\n- **Recent works retrieval**: Automatically fetch recent works (up to 50 items), including likes, comments, shares, engagement counts, and direct work links.\r\n- **Data highlight analysis**: Output TOP 3 engagement works analysis + account feature analysis (posting frequency, engagement trends, viral patterns).\r\n\r\n### Highlights\r\n\r\n- **Smart recognition**: Automatically detects input type (nickname/ID)—Chinese input uses nickname search, non-Chinese uses precise ID search.\r\n- **Account indexing**: Unlisted accounts support one-click indexing submission—data auto-syncs in about 30 minutes.\r\n- **Direct links**: Nickname links to account homepage; each work provides a direct video link.\r\n- **Safe & secure**: Data service-based access—no Douyin account login required.\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)\r\n- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.\r\n- Configure `REDFOX_API_KEY` on your device before using this skill.\r\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\r\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe your query needs in natural language—no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent | Example phrase | Result |\r\n| ------ | -------------- | ------ |\r\n| Query account works | \"Crawl Douyin works for 周幺姑家常菜\" | Fetch account basic info + recent work list + data highlight analysis |\r\n| Precise query | \"Query works for Douyin ID cdjjc028\" | Precise ID match, avoiding nickname ambiguity |\r\n| Submit account indexing | \"My account can't be found, Douyin ID is 1212_1234\" | Submit indexing request; query again in ~30 minutes |\r\n| Export data | \"Export works data for 周幺姑家常菜\" | Get structured works data |\r\n\r\n### Output Example\r\n\r\nAfter querying, you will receive the following structured results:\r\n\r\n**Account Basic Info**: Nickname (clickable to homepage), Douyin ID, region, followers, total likes, total works, RedFox Index\r\n\r\n**Recent Works List** (up to 50 items, reverse chronological):\r\n\r\n| # | Publish Time | Title | Likes | Comments | Shares | Engagement | Link |\r\n| … | … | … | … | … | … | … | Clickable to original video |\r\n\r\n**Data Highlights**: TOP 3 engagement works analysis + Account features (posting frequency, content direction, engagement trends, viral patterns)\r\n\r\n---\r\n\r\n(When no data is found, the system guides you to reply with a Douyin ID for indexing—data syncs in ~30 minutes.)\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario | Role | Example question | Benefit |\r\n| -------- | ---- | ---------------- | ------- |\r\n| Brand competitor monitoring | Brand marketing manager | \"Check the works data and engagement of this competitor Douyin account for me\" | Stay on top of competitor content trends; optimize your own strategy |\r\n| MCN creator evaluation | MCN operations staff | \"Show me this creator's followers, likes, and recent works data\" | Quickly evaluate creator value; support signing decisions |\r\n| Content optimization learning | Douyin creator | \"Check the works of top accounts in my niche and analyze viral patterns\" | Find content optimization directions; boost account engagement |\r\n| Data analysis reports | Data analyst | \"Export works data for these Douyin accounts for analysis\" | Efficiently fetch structured data to support analysis reports |\r\n\r\n---\r\n\r\n## Important Data Notes\r\n\r\n- The work list shows recent works only—up to 50 items in reverse chronological order, not the account's full historical works.\r\n- Number formatting: ≥10k displays as `x.xw` (e.g., 3.2w), ≥100M displays as `x.x亿`; <10k uses comma separators.\r\n- Douyin nicknames are not unique; nickname queries may return fuzzy matches—use Douyin ID for precise lookup.\r\n- Unlisted accounts can be submitted for indexing; data auto-syncs in about 30 minutes.\r\n- All data comes exclusively from the data platform; no third-party supplementation or estimation.\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n\r\n---\n\nFile v1.0.2:skill-card.md\n\n## Description: <br>\nRetrieves Douyin account profile details and up to 50 recent works through RedFox data APIs, returning engagement metrics, direct links, and account-level highlights. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[redfox-data](https://clawhub.ai/user/redfox-data) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nBrands, MCN operators, Douyin creators, and data analysts use this skill to inspect a Douyin account's recent works, engagement metrics, and content patterns. It can also guide account indexing when RedFox has not yet collected the requested account. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The security review reports that the script prints part of the RedFox API key in output, which could expose credential material in shared logs or CI systems. <br>\nMitigation: Use a revocable RedFox API key, avoid running the skill in shared logs or CI until the partial key print is removed, and rotate the key if logs may have been exposed. <br>\nRisk: The security review notes that Douyin account identifiers are sent to RedFox for lookup or indexing. <br>\nMitigation: Only submit Douyin account IDs that the user is comfortable sending to RedFox, and clarify consent before using the indexing flow for accounts that are not already collected. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill listing](https://clawhub.ai/redfox-data/skills/douyin-works-crawler) <br>\n- [Core workflow reference](artifact/references/core_workflow.md) <br>\n- [RedFoxHub API keys](https://redfox.hk/settings/api-keys?source=clawhub) <br>\n- [RedFoxHub](https://redfox.hk) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Markdown, JSON, Guidance] <br>\n**Output Format:** [Markdown report by default, with optional JSON output] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY; outputs are limited to RedFox-returned data and recent works, typically up to 50 items.] <br>\n\n## Skill Version(s): <br>\n1.0.2 (source: ClawHub release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.1: 7 files, 20148 bytes\n\nFiles: README.en.md (5966b), README.md (5487b), references/core_workflow.md (8398b), scripts/douyin_works_fetcher.py (20193b), skill-card.md (2288b), SKILL.md (9186b), _meta.json (139b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: douyin-works-crawler\r\ndescription: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。\r\n---\r\n\r\n# 抖音作品爬取\r\n\r\n> 输入抖音名称或ID，一键获取账号基础信息 + 近期作品内容\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品爬取是一款专为抖音内容分析打造的智能工具，帮助用户快速获取任意抖音账号的基础信息和近期作品数据。\r\n\r\n通过简单的账号名称或抖音号输入，你可以：\r\n- 📊 获取账号基础信息（粉丝数、获赞、作品总数、红狐指数等）\r\n- 📋 查看近期作品列表（最多50条，含互动数据和作品链接）\r\n- 🔍 发现互动TOP3作品，获取值得学习的内容分析\r\n- 📥 未收录账号支持一键提交收录，30分钟后自动同步\r\n\r\n适用于品牌方、MCN机构、内容运营、自媒体从业者等需要分析抖音账号表现的场景。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）\r\n- **📋 近期作品爬取**：自动获取近期作品列表（最多50条），包含点赞、评论、分享、互动数及作品链接\r\n- **🔍 数据亮点分析**：互动量TOP3作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 智能识别**：自动判断输入类型（昵称/抖音号），无需手动切换查询模式\r\n- **📥 账号收录**：未收录账号支持一键提交收录，30分钟后自动同步数据\r\n- **🔗 直达链接**：昵称跳转账号主页，作品列表跳转视频页面\r\n- **🔒 安全可靠**：API 接入方式，无需登录抖音账号\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.6+\r\n- 红狐数据API密钥（格式 `ak_xxx`）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：直接使用（推荐）\r\n\r\n1. 确保项目文件已下载到本地\r\n2. 配置环境变量：\r\n   ```bash\r\n   # macOS/Linux\r\n   export REDFOX_API_KEY=你的API密钥值\r\n\r\n   # Windows PowerShell\r\n   $env:REDFOX_API_KEY=\"你的API密钥值\"\r\n   ```\r\n3. 运行查询：\r\n   ```bash\r\n   python scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n   ```\r\n\r\n#### 方式二：在 Coze/Dify 等平台配置\r\n\r\n1. 将技能文件夹上传至平台\r\n2. 在环境变量中配置 `REDFOX_API_KEY`\r\n3. 配置触发词，即可通过对话调用\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐数据API密钥（格式 `ak_xxx`） |\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查询账号作品\r\n\r\n告诉助手你想查询的抖音账号：\r\n\r\n> 用户：爬取\"周幺姑家常菜\"的抖音作品\r\n>\r\n> 助手：已为您查询到「周幺姑家常菜」的账号数据，粉丝547.1w，近期47条作品...\r\n\r\n#### 2. 精准查询（推荐）\r\n\r\n使用抖音号进行精准查询，避免昵称模糊匹配：\r\n\r\n> 用户：帮我查询抖音号 cdjjc028 的作品\r\n>\r\n> 助手：已精准匹配到「周幺姑家常菜」的账号数据...\r\n\r\n#### 3. 账号收录\r\n\r\n当账号未被收录时，回复抖音号即可提交收录：\r\n\r\n> 用户：帮我查询\"xxx\"的作品\r\n>\r\n> 助手：未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。1. 回复抖音号...2. 下次再说；\r\n>\r\n> 用户：1212_1234\r\n>\r\n> 助手：已提交账号收录请求，系统正在同步数据，约30分钟后可再次查询。\r\n\r\n### 高级使用\r\n\r\n#### 4. 导出JSON格式\r\n\r\n需要结构化数据时，可指定JSON输出：\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"抖音号\" --output json\r\n```\r\n\r\n#### 5. 命令行直接提交收录\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"任意\" --sync \"抖音号\"\r\n```\r\n\r\n### 命令速查\r\n\r\n| 命令 | 功能 |\r\n|------|------|\r\n| `爬取抖音作品 [名称/抖音号]` | 查询账号作品数据 |\r\n| `抖音作品列表 [名称/抖音号]` | 获取近期作品列表 |\r\n| `抖音内容采集 [名称/抖音号]` | 采集账号内容 |\r\n| `导出抖音作品 [名称/抖音号]` | 导出作品数据 |\r\n| 回复抖音号 | 提交账号收录（未命中时） |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：品牌方竞品监测\r\n\r\n**角色**：品牌营销经理\r\n\r\n**需求**：监测竞品抖音账号的内容表现和互动数据\r\n\r\n**使用方式**：\r\n1. 输入竞品账号的抖音号进行查询\r\n2. 查看近期作品列表和互动数据\r\n3. 分析互动TOP3作品的内容特征\r\n\r\n**预期收益**：及时掌握竞品内容动态，优化自身内容策略\r\n\r\n---\r\n\r\n### 场景二：MCN 机构达人评估\r\n\r\n**角色**：MCN 运营人员\r\n\r\n**需求**：评估达人账号的数据表现和内容方向\r\n\r\n**使用方式**：\r\n1. 查询目标达人的账号基础信息（粉丝数、获赞、红狐指数）\r\n2. 分析近期作品的互动表现\r\n3. 查看账号特征分析，了解更新频率和内容方向\r\n\r\n**预期收益**：快速评估达人价值，辅助签约决策\r\n\r\n---\r\n\r\n### 场景三：自媒体内容优化\r\n\r\n**角色**：抖音内容创作者\r\n\r\n**需求**：学习同领域头部账号的爆款内容特征\r\n\r\n**使用方式**：\r\n1. 查询同领域头部账号的作品数据\r\n2. 查看互动TOP3作品的分析\r\n3. 学习爆款内容值得借鉴的点\r\n\r\n**预期收益**：找到内容优化方向，提升账号互动表现\r\n\r\n---\r\n\r\n### 场景四：数据分析报告\r\n\r\n**角色**：数据分析师\r\n\r\n**需求**：批量获取抖音账号的结构化数据用于分析\r\n\r\n**使用方式**：\r\n1. 使用 `--output json` 参数导出结构化数据\r\n2. 批量查询多个账号\r\n3. 结合其他数据进行综合分析\r\n\r\n**预期收益**：高效获取数据，支撑分析报告输出\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\ndouyin-works-crawler/\r\n├── scripts/\r\n│   └── douyin_works_fetcher.py   # 核心脚本（API调用+数据格式化）\r\n├── references/\r\n│   └── core_workflow.md          # 核心技能逻辑（接口规范、输出模板、处理规则）\r\n├── CONFIG.json                   # 技能配置文件\r\n└── SKILL.md                      # 技能说明文档\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.6+ |\r\n| 数据来源 | 红狐数据API |\r\n| 认证方式 | API Key（X-API-KEY请求头） |\r\n| 输出格式 | Markdown / JSON |\r\n\r\n\r\n### 核心模块说明\r\n\r\n- **DouyinWorksFetcher**：核心类，封装查询和收录两大功能\r\n  - `query_account()`：查询账号信息和作品列表\r\n  - `sync_account()`：提交账号收录请求\r\n  - `format_markdown()` / `format_json()`：输出格式化\r\n\r\n> 📌 **完整的接口规范、输出模板、处理规则等核心逻辑详见 [references/core_workflow.md](references/core_workflow.md)**，Agent 执行时必须遵循该文件中的所有规则。\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1: 运行时提示\"未设置环境变量 REDFOX_API_KEY\"怎么办？**\r\n\r\nA: 请先配置环境变量：\r\n```bash\r\n# macOS/Linux\r\nexport REDFOX_API_KEY=你的API密钥值\r\n\r\n# Windows PowerShell\r\n$env:REDFOX_API_KEY=\"你的API密钥值\"\r\n```\r\n\r\n**Q2: 红狐数据API密钥如何获取？**\r\n\r\nA: 前往红狐平台注册并申请API密钥，格式为 `ak_xxx`。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q3: 用昵称查询返回的不是我要找的账号怎么办？**\r\n\r\nA: 抖音昵称不唯一，建议使用抖音号进行精准查询。抖音号在抖音APP → 目标账号主页 → 昵称下方查看。\r\n\r\n**Q4: 为什么有些账号查不到？**\r\n\r\nA: 可能该账号尚未被红狐平台收录。查询未命中时会提示账号收录，回复抖音号即可提交收录，约30分钟后可再次查询。\r\n\r\n**Q5: 作品列表最多显示多少条？**\r\n\r\nA: 近期作品数据最多50条，按发布时间倒序排列。`awemeCount` 字段为账号历史作品总数，作品列表中的数量可能小于该值。\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q6: API调用报错\"积分不足\"怎么办？**\r\n\r\nA: 红狐API按调用次数计费，请前往红狐平台充值积分。\r\n\r\n**Q7: 查询超时怎么办？**\r\n\r\nA: 请检查网络连接是否正常，脚本默认超时时间为30秒。如持续超时，可稍后重试。\r\n\r\n---\r\n\r\n### 版本信息\r\n\r\n- **当前版本：** v2.3\r\n- **v2.3更新：** 新增账号收录功能；未查询到账号时输出收录提示；新增数据亮点模块（互动量TOP3+账号特征分析）；数据来源描述统一为\"红狐数据API\"\r\n- **v2.2更新：** 数字格式规范（万→w，≥1亿用亿，<1万千分位）；链接列格式固定为`[链接](url)`/`-`\r\n- **v2.1更新：** 接口新增url字段，支持作品直达链接输出\r\n- **v2.0更新：** 切换至 `/dyData/queryUserWithWorks` 接口，支持近期作品数据爬取\r\n- **v1.0更新：** 初始版本\n\nFile v1.0.1:README.md\n\n# 抖音作品爬取 / douyin-works-crawler\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品数据获取工具，输入抖音昵称或抖音号，一键获取账号基础信息与近期作品内容列表（最多 50 条），含互动数据和作品直达链接，并提供互动 TOP3 分析与账号特征总结，帮助用户快速掌握目标账号的内容表现。\r\n\r\n**核心价值**\r\n\r\n- **一键获取作品数据**：输入昵称或抖音号，自动获取账号粉丝数、获赞、作品总数等基础信息及近期作品列表。\r\n- **数据亮点自动分析**：互动量 TOP3 作品分析 + 账号特征总结（更新频率、内容方向、互动表现、爆款特征），快速发现值得学习的内容。\r\n- **作品直达链接**：每条作品提供直达链接，点击即可跳转查看原视频。\r\n- **未收录账号一键提交**：查询不到的账号，回复抖音号即可提交收录，约 30 分钟后自动同步数据。\r\n\r\n**适用对象**\r\n\r\n- 🏢 **品牌方 / 营销经理** — 监测竞品抖音账号的内容表现和互动数据。\r\n- 🛍️ **MCN / 运营人员** — 快速评估达人账号的数据表现和内容方向。\r\n- 📝 **抖音内容创作者** — 学习同领域头部账号的爆款内容特征。\r\n- 📊 **数据分析师** — 批量获取结构化数据用于分析报告。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）。\r\n- **近期作品获取**：自动获取近期作品列表（最多 50 条），包含点赞、评论、分享、互动数及作品直达链接。\r\n- **数据亮点分析**：输出互动量 TOP3 作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）。\r\n\r\n### 特色亮点\r\n\r\n- **智能识别**：自动判断输入类型（昵称/抖音号），含中文走昵称查询，非中文走抖音号精准查询。\r\n- **账号收录**：未收录账号支持一键提交收录，约 30 分钟后自动同步数据。\r\n- **直达链接**：昵称可跳转账号主页，每条作品提供直达链接。\r\n- **安全可靠**：通过数据服务接入，无需登录抖音账号。\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?souce=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述查询需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图 | 示例话术 | 效果 |\r\n| ---- | -------- | ---- |\r\n| 查询账号作品 | 「爬取周幺姑家常菜的抖音作品」 | 获取账号基础信息 + 近期作品列表 + 数据亮点分析 |\r\n| 精准查询 | 「帮我查询抖音号 cdjjc028 的作品」 | 按抖音号精准匹配，避免昵称模糊 |\r\n| 提交账号收录 | 「我的号查不到，抖音号是 1212_1234」 | 提交收录请求，约 30 分钟后可再次查询 |\r\n| 导出数据 | 「导出周幺姑家常菜的作品数据」 | 获取结构化作品数据 |\r\n\r\n### 输出示例\r\n\r\n完成查询后，你将收到以下结构化的结果：\r\n\r\n**账号基础信息**：昵称（可点击跳转主页）、抖音号、地域、粉丝数、获赞、作品总数、红狐指数\r\n\r\n**近期作品列表**（最多 50 条，按发布时间倒序）：\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n| … | … | … | … | … | … | … | 可点击跳转原视频 |\r\n\r\n**数据亮点**：互动量 TOP3 作品分析 + 账号特征（更新频率、内容方向、互动表现、爆款特征）\r\n\r\n---\r\n\r\n（查询不到数据时，系统引导回复抖音号提交收录，30 分钟后自动同步。）\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ---- | ---- | -------- | ---- |\r\n| 品牌竞品监测 | 品牌营销经理 | 「帮我查一下竞品抖音号的作品数据和互动表现」 | 及时掌握竞品内容动态，优化自身策略 |\r\n| MCN 达人评估 | MCN 运营人员 | 「帮我看看这个达人的粉丝数、获赞和近期作品数据」 | 快速评估达人价值，辅助签约决策 |\r\n| 内容优化学习 | 抖音创作者 | 「帮我查同领域头部账号的作品，分析爆款特征」 | 找到内容优化方向，提升账号互动表现 |\r\n| 数据分析报告 | 数据分析师 | 「帮我导出这几个抖音号的作品数据做分析」 | 高效获取结构化数据，支撑分析报告 |\r\n\r\n---\r\n\r\n## 重要数据说明\r\n\r\n- 作品列表为近期作品数据，最多 50 条，按发布时间倒序排列，非账号全部历史作品。\r\n- 数字格式：≥1 万显示为 `x.xw`（如 3.2w），≥1 亿显示为 `x.x亿`，<1 万用千分位逗号。\r\n- 抖音昵称不唯一，用昵称查询可能返回模糊匹配结果，建议用抖音号进行精准查询。\r\n- 查询不到的账号支持提交收录，约 30 分钟后自动同步数据。\r\n- 所有数据唯一来源为数据平台，不会从第三方渠道补充或估算。\r\n\r\n---\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n  \"slug\": \"douyin-works-crawler\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1781146395164\n}\n\nFile v1.0.1:references/core_workflow.md\n\n# 核心技能逻辑\r\n\r\n> 本文件为 douyin-works-crawler 技能的完整执行逻辑参考，SKILL.md 通过引用本文件获取详细规则。\r\n\r\n---\r\n\r\n## 1. 数据来源\r\n\r\n**唯一数据源：红狐数据API**\r\n\r\n### 1.1 查询接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/story/api/dyData/queryUserWithWorks` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/story/api/dyData/queryUserWithWorks`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 否* | 抖音号/uid（支持 unique_id、short_id、uid 任一匹配） |\r\n| `accountName` | String | 否* | 作者/账号名 |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n> *accountId和accountName至少传一个\r\n\r\n> **查询精准度提醒：** 抖音昵称不唯一，使用accountName可能返回首个模糊匹配账号。若需精准查询，建议使用accountId（抖音号）。\r\n\r\n**响应字段：**\r\n\r\n- 账号级：nickname / accountId / uniqueId / uid / secUid / province / city / ipLocation / followerCount / awemeCount / totalFavorited / redfoxIndex\r\n- 作品级（workList，近期作品数据，最多50条，按发布时间倒序）：title / likeCount / commentCount / shareCount / interactiveCount / publishTime / url\r\n\r\n**数据范围说明：**\r\n\r\n- API返回的 `workList` 为**近期作品数据，最多50条**，按发布时间倒序排列\r\n- 实际返回数量取决于账号发布频率，通常为 1~50 条\r\n- `awemeCount` 字段为账号历史作品**总数**，workList中的数量可能小于该值\r\n- 若账号近期无作品或作品未被收录，workList 为空列表\r\n\r\n### 1.2 账号收录接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/dyUser/syncUserNotes` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/dyUser/syncUserNotes`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 是 | 抖音账号ID（支持 unique_id、short_id、uid 任一匹配） |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n**响应说明：** 异步同步触发接口，调用成功返回 HTTP 200，无响应体。系统异步拉取账号文章/作品数据，约30分钟后可查询。\r\n\r\n**错误码：** 200=成功 | 400=参数错误 | 500=业务异常\r\n\r\n---\r\n\r\n## 2. 查询未命中处理\r\n\r\n当查询未找到目标账号时，**严禁联网搜索**，按以下流程处理：\r\n\r\n1. **匹配到错误账号** → 提示：\"昵称查询返回的是「[实际匹配的昵称]」，非您要找的账号。请提供目标账号的**抖音号**进行精准查询。\"\r\n2. **未查询到账号** → 输出账号收录提示，引导用户进行账号收录：\r\n\r\n```\r\n未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。\r\n1. 回复抖音号（在抖音个人主页显示的ID，如 1212_1234），即可进行账号收录。30分钟后将自动为您推作品查询报告~\r\n2. 下次再说；\r\n```\r\n\r\n3. **用户回复抖音号** → 调用账号收录接口 `POST /dyUser/syncUserNotes`，传入用户提供的抖音号作为 `accountId`，触发异步同步任务\r\n4. **用户选择\"下次再说\"** → 结束当前流程\r\n\r\n**收录成功后提示：** \"已提交账号收录请求，系统正在同步数据，约30分钟后可再次查询该账号的作品数据。\"\r\n\r\n**收录失败提示：** 根据错误码告知用户具体原因。\r\n\r\n### 降级策略\r\n\r\nAPI调用失败（如积分不足、网络异常）时明确告知用户错误原因，**严禁联网搜索、严禁从第三方渠道估算或补充API未返回的字段**。\r\n\r\n---\r\n\r\n## 3. 输出模板\r\n\r\n**使用说明：** 严格按模板输出，不可省略章节。数据来源于API，如实展示。\r\n\r\n**数字格式规范：** ≥1万用 `w`（如 3.2w），≥1亿用 `亿`（如 1.5亿），<1万用千分位逗号（如 8,642）。\r\n\r\n**链接列格式：** 有url时显示 `[链接](url)`，无url时显示 `-`。\r\n\r\n**昵称链接格式：** 昵称字段使用 `[nickname](https://www.douyin.com/user/{secUid})` 格式，secUid 为空时显示纯文本。\r\n\r\n```markdown\r\n## 🎬 [nickname] - 抖音作品数据\r\n\r\n### 账号基础信息\r\n\r\n| 昵称 | 抖音号 | UID | 地域 | 粉丝数 | 获赞 | 作品总数 | 红狐指数 |\r\n|------|--------|-----|------|--------|------|---------|---------|\r\n| [nickname](https://www.douyin.com/user/[secUid]) | [accountId] | [uid] | [province·city] | [followerCount] | [totalFavorited] | [awemeCount] | [redfoxIndex] |\r\n\r\n---\r\n\r\n### 近期作品（共[N]条）\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n|---|---------|------|------|------|------|------|------|\r\n| 1 | [publishTime] | [title] | [likeCount] | [commentCount] | [shareCount] | [interactiveCount] | [链接](url) / - |\r\n\r\n> 作品列表为近期作品数据，最多50条（按发布时间倒序），账号历史作品总数为 [awemeCount] 条。\r\n\r\n---\r\n\r\n### 数据亮点\r\n\r\n#### 互动量TOP3\r\n\r\n🥇 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥈 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥉 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n\r\n#### 账号特征分析\r\n\r\n- **更新频率：** [基于近期作品发布间隔分析]\r\n- **内容方向：** [基于作品标题关键词归纳内容赛道]\r\n- **互动表现：** [基于互动数据整体趋势分析]\r\n- **爆款特征：** [基于TOP3作品共性总结]\r\n\r\n---\r\n\r\n### 数据说明\r\n\r\n- **数据范围：** 近期作品数据，最多50条，按发布时间倒序\r\n- **作品链接：** 接口返回url字段，提供作品直达链接；url为空时显示\"-\"\r\n- **数字格式：** ≥1万显示为x.xw（如3.2w），≥1亿显示为x.x亿，<1万用千分位逗号\r\n- **数据来源：** 红狐数据API\r\n\r\n*爬取时间：[YYYY-MM-DD HH:mm]*\r\n```\r\n\r\n---\r\n\r\n## 4. 脚本调用\r\n\r\n> ⚠️ **单次调用原则：** 每次查询仅执行一次脚本调用，使用默认的 `markdown` 输出即可获得完整格式化报告，**禁止重复调用（如先json再markdown）以避免浪费API积分**。\r\n\r\n**查询账号作品：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n```\r\n\r\n**提交账号收录：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"任意\" --sync \"抖音号\"\r\n```\r\n\r\n**参数说明：**\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--account` | 抖音昵称或抖音号（自动识别：含中文→昵称，非中文→抖音号） |\r\n| `--output` | 输出格式：`markdown`（默认）/ `json` |\r\n| `--sync` | 提交账号收录，传入抖音号触发异步同步 |\r\n\r\n**自动识别逻辑：**\r\n- 输入含中文 → 使用 `accountName` 参数查询（昵称模糊匹配）\r\n- 输入非中文 → 使用 `accountId` 参数查询（抖音号精准匹配）\r\n\r\n---\r\n\r\n## 5. 注意事项\r\n\r\n- 🔌 **唯一数据源：** 所有数据仅从红狐API获取，不使用第三方渠道补充或估算\r\n- 📊 **数据范围：** 近期作品数据，最多50条，非账号全部历史作品\r\n- 🔢 **数字格式：** ≥1万显示为 `x.xw`（如3.2w），≥1亿显示为 `x.x亿`，<1万用千分位逗号（如8,642）\r\n- 🔗 **作品链接：** 接口返回url字段，表格中显示为 `[链接](url)`，无url时显示 `-`\r\n- ❌ **未查询到账号：** API返回空数据时，输出账号收录提示文案，引导用户回复抖音号进行账号收录，**严禁联网搜索、严禁生成无依据报告**\r\n- 📥 **账号收录：** 用户回复抖音号后，调用 `POST /dyUser/syncUserNotes` 接口提交收录请求，约30分钟后可再次查询\r\n- ❌ **昵称匹配到错误账号：** 提示用户当前匹配结果非目标账号，引导提供抖音号重新查询，**严禁联网搜索**\r\n- ✅ **如实输出：** 作品数量如实展示\n\nFile v1.0.1:README.en.md\n\n# Douyin Works Crawler / douyin-works-crawler\r\n\r\n---\r\n\r\n## Overview\r\n\r\nA Douyin content data retrieval tool. Enter a Douyin nickname or ID to instantly fetch account basic info and recent works (up to 50 items), including engagement data and direct video links—plus a TOP 3 engagement analysis and account feature summary to help you quickly understand the target account's content performance.\r\n\r\n**Core Value**\r\n\r\n- **One-click works retrieval**: Enter a nickname or Douyin ID to automatically fetch account basic info (followers, total likes, total works, RedFox Index) and recent work lists.\r\n- **Auto data highlight analysis**: TOP 3 engagement works analysis + account feature summary (posting frequency, content direction, engagement trends, viral patterns)—quickly identify content worth learning from.\r\n- **Direct work links**: Each work comes with a direct link—click to jump to the original video.\r\n- **One-click unlisted account submission**: For accounts not yet indexed, reply with the Douyin ID to submit for indexing—data auto-syncs in about 30 minutes.\r\n\r\n**Intended Users**\r\n\r\n- 🏢 **Brands / marketing managers** — Monitor competitor Douyin account content performance and engagement data.\r\n- 🛍️ **MCN / operations staff** — Quickly evaluate creator account data performance and content direction.\r\n- 📝 **Douyin content creators** — Learn viral content patterns from top accounts in your niche.\r\n- 📊 **Data analysts** — Batch-fetch structured data for analysis reports.\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Account info query**: Enter a Douyin nickname or ID to instantly fetch account basic data (followers, total likes, total works, RedFox Index, etc.).\r\n- **Recent works retrieval**: Automatically fetch recent works (up to 50 items), including likes, comments, shares, engagement counts, and direct work links.\r\n- **Data highlight analysis**: Output TOP 3 engagement works analysis + account feature analysis (posting frequency, engagement trends, viral patterns).\r\n\r\n### Highlights\r\n\r\n- **Smart recognition**: Automatically detects input type (nickname/ID)—Chinese input uses nickname search, non-Chinese uses precise ID search.\r\n- **Account indexing**: Unlisted accounts support one-click indexing submission—data auto-syncs in about 30 minutes.\r\n- **Direct links**: Nickname links to account homepage; each work provides a direct video link.\r\n- **Safe & secure**: Data service-based access—no Douyin account login required.\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`)\r\n- Register at [RedFoxHub](https://redfox.hk?souce=github) to obtain `REDFOX_API_KEY`.\r\n- Configure `REDFOX_API_KEY` on your device before using this skill.\r\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\r\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe your query needs in natural language—no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent | Example phrase | Result |\r\n| ------ | -------------- | ------ |\r\n| Query account works | \"Crawl Douyin works for 周幺姑家常菜\" | Fetch account basic info + recent work list + data highlight analysis |\r\n| Precise query | \"Query works for Douyin ID cdjjc028\" | Precise ID match, avoiding nickname ambiguity |\r\n| Submit account indexing | \"My account can't be found, Douyin ID is 1212_1234\" | Submit indexing request; query again in ~30 minutes |\r\n| Export data | \"Export works data for 周幺姑家常菜\" | Get structured works data |\r\n\r\n### Output Example\r\n\r\nAfter querying, you will receive the following structured results:\r\n\r\n**Account Basic Info**: Nickname (clickable to homepage), Douyin ID, region, followers, total likes, total works, RedFox Index\r\n\r\n**Recent Works List** (up to 50 items, reverse chronological):\r\n\r\n| # | Publish Time | Title | Likes | Comments | Shares | Engagement | Link |\r\n| … | … | … | … | … | … | … | Clickable to original video |\r\n\r\n**Data Highlights**: TOP 3 engagement works analysis + Account features (posting frequency, content direction, engagement trends, viral patterns)\r\n\r\n---\r\n\r\n(When no data is found, the system guides you to reply with a Douyin ID for indexing—data syncs in ~30 minutes.)\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario | Role | Example question | Benefit |\r\n| -------- | ---- | ---------------- | ------- |\r\n| Brand competitor monitoring | Brand marketing manager | \"Check the works data and engagement of this competitor Douyin account for me\" | Stay on top of competitor content trends; optimize your own strategy |\r\n| MCN creator evaluation | MCN operations staff | \"Show me this creator's followers, likes, and recent works data\" | Quickly evaluate creator value; support signing decisions |\r\n| Content optimization learning | Douyin creator | \"Check the works of top accounts in my niche and analyze viral patterns\" | Find content optimization directions; boost account engagement |\r\n| Data analysis reports | Data analyst | \"Export works data for these Douyin accounts for analysis\" | Efficiently fetch structured data to support analysis reports |\r\n\r\n---\r\n\r\n## Important Data Notes\r\n\r\n- The work list shows recent works only—up to 50 items in reverse chronological order, not the account's full historical works.\r\n- Number formatting: ≥10k displays as `x.xw` (e.g., 3.2w), ≥100M displays as `x.x亿`; <10k uses comma separators.\r\n- Douyin nicknames are not unique; nickname queries may return fuzzy matches—use Douyin ID for precise lookup.\r\n- Unlisted accounts can be submitted for indexing; data auto-syncs in about 30 minutes.\r\n- All data comes exclusively from the data platform; no third-party supplementation or estimation.\r\n\r\n---\n\nFile v1.0.1:skill-card.md\n\n## Description: <br>\n抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[redfox-data](https://clawhub.ai/user/redfox-data) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nBrands, MCN operators, content creators, and data analysts use this skill to retrieve recent Douyin account works and engagement summaries from RedFox APIs for monitoring, evaluation, content analysis, and report preparation. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill sends Douyin names or IDs to RedFox APIs and consumes a RedFox API key or credits. <br>\nMitigation: Install and use it only when RedFox data submission and API-key use are acceptable for the account being queried. <br>\nRisk: The command-line script prints the first characters of the configured API key. <br>\nMitigation: Avoid running it in shared logs, screenshots, or recorded sessions until the partial API-key print is removed. <br>\nRisk: Nickname searches can return a fuzzy or unintended Douyin account. <br>\nMitigation: Use precise Douyin IDs when querying accounts or submitting accounts for indexing. <br>\n\n\n## Reference(s): <br>\n- [ClawHub listing](https://clawhub.ai/redfox-data/douyin-works-crawler) <br>\n- [Core workflow](references/core_workflow.md) <br>\n- [RedFoxHub API keys](https://redfox.hk/settings/api-keys?souce=github) <br>\n- [RedFox data platform](https://redfox.hk) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [markdown, json, guidance] <br>\n**Output Format:** [Markdown report or JSON object] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Recent works are capped at 50 items; results may include account indexing guidance when no account is found.] <br>\n\n## Skill Version(s): <br>\n1.0.1 (source: evidence.release.version, released 2026-06-11) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.0: 7 files, 20107 bytes\n\nFiles: README.en.md (5966b), README.md (5487b), references/core_workflow.md (8172b), scripts/douyin_works_fetcher.py (20193b), skill-card.md (2514b), SKILL.md (9186b), _meta.json (139b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: douyin-works-crawler\r\ndescription: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。\r\n---\r\n\r\n# 抖音作品爬取\r\n\r\n> 输入抖音名称或ID，一键获取账号基础信息 + 近期作品内容\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品爬取是一款专为抖音内容分析打造的智能工具，帮助用户快速获取任意抖音账号的基础信息和近期作品数据。\r\n\r\n通过简单的账号名称或抖音号输入，你可以：\r\n- 📊 获取账号基础信息（粉丝数、获赞、作品总数、红狐指数等）\r\n- 📋 查看近期作品列表（最多50条，含互动数据和作品链接）\r\n- 🔍 发现互动TOP3作品，获取值得学习的内容分析\r\n- 📥 未收录账号支持一键提交收录，30分钟后自动同步\r\n\r\n适用于品牌方、MCN机构、内容运营、自媒体从业者等需要分析抖音账号表现的场景。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）\r\n- **📋 近期作品爬取**：自动获取近期作品列表（最多50条），包含点赞、评论、分享、互动数及作品链接\r\n- **🔍 数据亮点分析**：互动量TOP3作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 智能识别**：自动判断输入类型（昵称/抖音号），无需手动切换查询模式\r\n- **📥 账号收录**：未收录账号支持一键提交收录，30分钟后自动同步数据\r\n- **🔗 直达链接**：昵称跳转账号主页，作品列表跳转视频页面\r\n- **🔒 安全可靠**：API 接入方式，无需登录抖音账号\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.6+\r\n- 红狐数据API密钥（格式 `ak_xxx`）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：直接使用（推荐）\r\n\r\n1. 确保项目文件已下载到本地\r\n2. 配置环境变量：\r\n   ```bash\r\n   # macOS/Linux\r\n   export REDFOX_API_KEY=你的API密钥值\r\n\r\n   # Windows PowerShell\r\n   $env:REDFOX_API_KEY=\"你的API密钥值\"\r\n   ```\r\n3. 运行查询：\r\n   ```bash\r\n   python scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n   ```\r\n\r\n#### 方式二：在 Coze/Dify 等平台配置\r\n\r\n1. 将技能文件夹上传至平台\r\n2. 在环境变量中配置 `REDFOX_API_KEY`\r\n3. 配置触发词，即可通过对话调用\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐数据API密钥（格式 `ak_xxx`） |\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查询账号作品\r\n\r\n告诉助手你想查询的抖音账号：\r\n\r\n> 用户：爬取\"周幺姑家常菜\"的抖音作品\r\n>\r\n> 助手：已为您查询到「周幺姑家常菜」的账号数据，粉丝547.1w，近期47条作品...\r\n\r\n#### 2. 精准查询（推荐）\r\n\r\n使用抖音号进行精准查询，避免昵称模糊匹配：\r\n\r\n> 用户：帮我查询抖音号 cdjjc028 的作品\r\n>\r\n> 助手：已精准匹配到「周幺姑家常菜」的账号数据...\r\n\r\n#### 3. 账号收录\r\n\r\n当账号未被收录时，回复抖音号即可提交收录：\r\n\r\n> 用户：帮我查询\"xxx\"的作品\r\n>\r\n> 助手：未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。1. 回复抖音号...2. 下次再说；\r\n>\r\n> 用户：1212_1234\r\n>\r\n> 助手：已提交账号收录请求，系统正在同步数据，约30分钟后可再次查询。\r\n\r\n### 高级使用\r\n\r\n#### 4. 导出JSON格式\r\n\r\n需要结构化数据时，可指定JSON输出：\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"抖音号\" --output json\r\n```\r\n\r\n#### 5. 命令行直接提交收录\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"任意\" --sync \"抖音号\"\r\n```\r\n\r\n### 命令速查\r\n\r\n| 命令 | 功能 |\r\n|------|------|\r\n| `爬取抖音作品 [名称/抖音号]` | 查询账号作品数据 |\r\n| `抖音作品列表 [名称/抖音号]` | 获取近期作品列表 |\r\n| `抖音内容采集 [名称/抖音号]` | 采集账号内容 |\r\n| `导出抖音作品 [名称/抖音号]` | 导出作品数据 |\r\n| 回复抖音号 | 提交账号收录（未命中时） |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：品牌方竞品监测\r\n\r\n**角色**：品牌营销经理\r\n\r\n**需求**：监测竞品抖音账号的内容表现和互动数据\r\n\r\n**使用方式**：\r\n1. 输入竞品账号的抖音号进行查询\r\n2. 查看近期作品列表和互动数据\r\n3. 分析互动TOP3作品的内容特征\r\n\r\n**预期收益**：及时掌握竞品内容动态，优化自身内容策略\r\n\r\n---\r\n\r\n### 场景二：MCN 机构达人评估\r\n\r\n**角色**：MCN 运营人员\r\n\r\n**需求**：评估达人账号的数据表现和内容方向\r\n\r\n**使用方式**：\r\n1. 查询目标达人的账号基础信息（粉丝数、获赞、红狐指数）\r\n2. 分析近期作品的互动表现\r\n3. 查看账号特征分析，了解更新频率和内容方向\r\n\r\n**预期收益**：快速评估达人价值，辅助签约决策\r\n\r\n---\r\n\r\n### 场景三：自媒体内容优化\r\n\r\n**角色**：抖音内容创作者\r\n\r\n**需求**：学习同领域头部账号的爆款内容特征\r\n\r\n**使用方式**：\r\n1. 查询同领域头部账号的作品数据\r\n2. 查看互动TOP3作品的分析\r\n3. 学习爆款内容值得借鉴的点\r\n\r\n**预期收益**：找到内容优化方向，提升账号互动表现\r\n\r\n---\r\n\r\n### 场景四：数据分析报告\r\n\r\n**角色**：数据分析师\r\n\r\n**需求**：批量获取抖音账号的结构化数据用于分析\r\n\r\n**使用方式**：\r\n1. 使用 `--output json` 参数导出结构化数据\r\n2. 批量查询多个账号\r\n3. 结合其他数据进行综合分析\r\n\r\n**预期收益**：高效获取数据，支撑分析报告输出\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\ndouyin-works-crawler/\r\n├── scripts/\r\n│   └── douyin_works_fetcher.py   # 核心脚本（API调用+数据格式化）\r\n├── references/\r\n│   └── core_workflow.md          # 核心技能逻辑（接口规范、输出模板、处理规则）\r\n├── CONFIG.json                   # 技能配置文件\r\n└── SKILL.md                      # 技能说明文档\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.6+ |\r\n| 数据来源 | 红狐数据API |\r\n| 认证方式 | API Key（X-API-KEY请求头） |\r\n| 输出格式 | Markdown / JSON |\r\n\r\n\r\n### 核心模块说明\r\n\r\n- **DouyinWorksFetcher**：核心类，封装查询和收录两大功能\r\n  - `query_account()`：查询账号信息和作品列表\r\n  - `sync_account()`：提交账号收录请求\r\n  - `format_markdown()` / `format_json()`：输出格式化\r\n\r\n> 📌 **完整的接口规范、输出模板、处理规则等核心逻辑详见 [references/core_workflow.md](references/core_workflow.md)**，Agent 执行时必须遵循该文件中的所有规则。\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装相关问题\r\n\r\n**Q1: 运行时提示\"未设置环境变量 REDFOX_API_KEY\"怎么办？**\r\n\r\nA: 请先配置环境变量：\r\n```bash\r\n# macOS/Linux\r\nexport REDFOX_API_KEY=你的API密钥值\r\n\r\n# Windows PowerShell\r\n$env:REDFOX_API_KEY=\"你的API密钥值\"\r\n```\r\n\r\n**Q2: 红狐数据API密钥如何获取？**\r\n\r\nA: 前往红狐平台注册并申请API密钥，格式为 `ak_xxx`。\r\n\r\n---\r\n\r\n### 使用相关问题\r\n\r\n**Q3: 用昵称查询返回的不是我要找的账号怎么办？**\r\n\r\nA: 抖音昵称不唯一，建议使用抖音号进行精准查询。抖音号在抖音APP → 目标账号主页 → 昵称下方查看。\r\n\r\n**Q4: 为什么有些账号查不到？**\r\n\r\nA: 可能该账号尚未被红狐平台收录。查询未命中时会提示账号收录，回复抖音号即可提交收录，约30分钟后可再次查询。\r\n\r\n**Q5: 作品列表最多显示多少条？**\r\n\r\nA: 近期作品数据最多50条，按发布时间倒序排列。`awemeCount` 字段为账号历史作品总数，作品列表中的数量可能小于该值。\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q6: API调用报错\"积分不足\"怎么办？**\r\n\r\nA: 红狐API按调用次数计费，请前往红狐平台充值积分。\r\n\r\n**Q7: 查询超时怎么办？**\r\n\r\nA: 请检查网络连接是否正常，脚本默认超时时间为30秒。如持续超时，可稍后重试。\r\n\r\n---\r\n\r\n### 版本信息\r\n\r\n- **当前版本：** v2.3\r\n- **v2.3更新：** 新增账号收录功能；未查询到账号时输出收录提示；新增数据亮点模块（互动量TOP3+账号特征分析）；数据来源描述统一为\"红狐数据API\"\r\n- **v2.2更新：** 数字格式规范（万→w，≥1亿用亿，<1万千分位）；链接列格式固定为`[链接](url)`/`-`\r\n- **v2.1更新：** 接口新增url字段，支持作品直达链接输出\r\n- **v2.0更新：** 切换至 `/dyData/queryUserWithWorks` 接口，支持近期作品数据爬取\r\n- **v1.0更新：** 初始版本\n\nFile v1.0.0:README.md\n\n# 抖音作品爬取 / douyin-works-crawler\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品数据获取工具，输入抖音昵称或抖音号，一键获取账号基础信息与近期作品内容列表（最多 50 条），含互动数据和作品直达链接，并提供互动 TOP3 分析与账号特征总结，帮助用户快速掌握目标账号的内容表现。\r\n\r\n**核心价值**\r\n\r\n- **一键获取作品数据**：输入昵称或抖音号，自动获取账号粉丝数、获赞、作品总数等基础信息及近期作品列表。\r\n- **数据亮点自动分析**：互动量 TOP3 作品分析 + 账号特征总结（更新频率、内容方向、互动表现、爆款特征），快速发现值得学习的内容。\r\n- **作品直达链接**：每条作品提供直达链接，点击即可跳转查看原视频。\r\n- **未收录账号一键提交**：查询不到的账号，回复抖音号即可提交收录，约 30 分钟后自动同步数据。\r\n\r\n**适用对象**\r\n\r\n- 🏢 **品牌方 / 营销经理** — 监测竞品抖音账号的内容表现和互动数据。\r\n- 🛍️ **MCN / 运营人员** — 快速评估达人账号的数据表现和内容方向。\r\n- 📝 **抖音内容创作者** — 学习同领域头部账号的爆款内容特征。\r\n- 📊 **数据分析师** — 批量获取结构化数据用于分析报告。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）。\r\n- **近期作品获取**：自动获取近期作品列表（最多 50 条），包含点赞、评论、分享、互动数及作品直达链接。\r\n- **数据亮点分析**：输出互动量 TOP3 作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）。\r\n\r\n### 特色亮点\r\n\r\n- **智能识别**：自动判断输入类型（昵称/抖音号），含中文走昵称查询，非中文走抖音号精准查询。\r\n- **账号收录**：未收录账号支持一键提交收录，约 30 分钟后自动同步数据。\r\n- **直达链接**：昵称可跳转账号主页，每条作品提供直达链接。\r\n- **安全可靠**：通过数据服务接入，无需登录抖音账号。\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?souce=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述查询需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图 | 示例话术 | 效果 |\r\n| ---- | -------- | ---- |\r\n| 查询账号作品 | 「爬取周幺姑家常菜的抖音作品」 | 获取账号基础信息 + 近期作品列表 + 数据亮点分析 |\r\n| 精准查询 | 「帮我查询抖音号 cdjjc028 的作品」 | 按抖音号精准匹配，避免昵称模糊 |\r\n| 提交账号收录 | 「我的号查不到，抖音号是 1212_1234」 | 提交收录请求，约 30 分钟后可再次查询 |\r\n| 导出数据 | 「导出周幺姑家常菜的作品数据」 | 获取结构化作品数据 |\r\n\r\n### 输出示例\r\n\r\n完成查询后，你将收到以下结构化的结果：\r\n\r\n**账号基础信息**：昵称（可点击跳转主页）、抖音号、地域、粉丝数、获赞、作品总数、红狐指数\r\n\r\n**近期作品列表**（最多 50 条，按发布时间倒序）：\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n| … | … | … | … | … | … | … | 可点击跳转原视频 |\r\n\r\n**数据亮点**：互动量 TOP3 作品分析 + 账号特征（更新频率、内容方向、互动表现、爆款特征）\r\n\r\n---\r\n\r\n（查询不到数据时，系统引导回复抖音号提交收录，30 分钟后自动同步。）\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ---- | ---- | -------- | ---- |\r\n| 品牌竞品监测 | 品牌营销经理 | 「帮我查一下竞品抖音号的作品数据和互动表现」 | 及时掌握竞品内容动态，优化自身策略 |\r\n| MCN 达人评估 | MCN 运营人员 | 「帮我看看这个达人的粉丝数、获赞和近期作品数据」 | 快速评估达人价值，辅助签约决策 |\r\n| 内容优化学习 | 抖音创作者 | 「帮我查同领域头部账号的作品，分析爆款特征」 | 找到内容优化方向，提升账号互动表现 |\r\n| 数据分析报告 | 数据分析师 | 「帮我导出这几个抖音号的作品数据做分析」 | 高效获取结构化数据，支撑分析报告 |\r\n\r\n---\r\n\r\n## 重要数据说明\r\n\r\n- 作品列表为近期作品数据，最多 50 条，按发布时间倒序排列，非账号全部历史作品。\r\n- 数字格式：≥1 万显示为 `x.xw`（如 3.2w），≥1 亿显示为 `x.x亿`，<1 万用千分位逗号。\r\n- 抖音昵称不唯一，用昵称查询可能返回模糊匹配结果，建议用抖音号进行精准查询。\r\n- 查询不到的账号支持提交收录，约 30 分钟后自动同步数据。\r\n- 所有数据唯一来源为数据平台，不会从第三方渠道补充或估算。\r\n\r\n---\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n  \"slug\": \"douyin-works-crawler\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1781081267639\n}\n\nFile v1.0.0:references/core_workflow.md\n\n# 核心技能逻辑\r\n\r\n> 本文件为 douyin-works-crawler 技能的完整执行逻辑参考，SKILL.md 通过引用本文件获取详细规则。\r\n\r\n---\r\n\r\n## 1. 数据来源\r\n\r\n**唯一数据源：红狐数据API**\r\n\r\n### 1.1 查询接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/story/api/dyData/queryUserWithWorks` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/story/api/dyData/queryUserWithWorks`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 否* | 抖音号/uid（支持 unique_id、short_id、uid 任一匹配） |\r\n| `accountName` | String | 否* | 作者/账号名 |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n> *accountId和accountName至少传一个\r\n\r\n> **查询精准度提醒：** 抖音昵称不唯一，使用accountName可能返回首个模糊匹配账号。若需精准查询，建议使用accountId（抖音号）。\r\n\r\n**响应字段：**\r\n\r\n- 账号级：nickname / accountId / uniqueId / uid / secUid / province / city / ipLocation / followerCount / awemeCount / totalFavorited / redfoxIndex\r\n- 作品级（workList，近期作品数据，最多50条，按发布时间倒序）：title / likeCount / commentCount / shareCount / interactiveCount / publishTime / url\r\n\r\n**数据范围说明：**\r\n\r\n- API返回的 `workList` 为**近期作品数据，最多50条**，按发布时间倒序排列\r\n- 实际返回数量取决于账号发布频率，通常为 1~50 条\r\n- `awemeCount` 字段为账号历史作品**总数**，workList中的数量可能小于该值\r\n- 若账号近期无作品或作品未被收录，workList 为空列表\r\n\r\n### 1.2 账号收录接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/dyUser/syncUserNotes` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/dyUser/syncUserNotes`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 是 | 抖音账号ID（支持 unique_id、short_id、uid 任一匹配） |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n**响应说明：** 异步同步触发接口，调用成功返回 HTTP 200，无响应体。系统异步拉取账号文章/作品数据，约30分钟后可查询。\r\n\r\n**错误码：** 200=成功 | 400=参数错误 | 500=业务异常\r\n\r\n---\r\n\r\n## 2. 查询未命中处理\r\n\r\n当查询未找到目标账号时，**严禁联网搜索**，按以下流程处理：\r\n\r\n1. **匹配到错误账号** → 提示：\"昵称查询返回的是「[实际匹配的昵称]」，非您要找的账号。请提供目标账号的**抖音号**进行精准查询。\"\r\n2. **未查询到账号** → 输出账号收录提示，引导用户进行账号收录：\r\n\r\n```\r\n未查询到当前账号的相关信息，可提交当前抖音账号进行账号收录。\r\n1. 回复抖音号（在抖音个人主页显示的ID，如 1212_1234），即可进行账号收录。30分钟后将自动为您推作品查询报告~\r\n2. 下次再说；\r\n```\r\n\r\n3. **用户回复抖音号** → 调用账号收录接口 `POST /dyUser/syncUserNotes`，传入用户提供的抖音号作为 `accountId`，触发异步同步任务\r\n4. **用户选择\"下次再说\"** → 结束当前流程\r\n\r\n**收录成功后提示：** \"已提交账号收录请求，系统正在同步数据，约30分钟后可再次查询该账号的作品数据。\"\r\n\r\n**收录失败提示：** 根据错误码告知用户具体原因。\r\n\r\n### 降级策略\r\n\r\nAPI调用失败（如积分不足、网络异常）时明确告知用户错误原因，**严禁联网搜索、严禁从第三方渠道估算或补充API未返回的字段**。\r\n\r\n---\r\n\r\n## 3. 输出模板\r\n\r\n**使用说明：** 严格按模板输出，不可省略章节。数据来源于API，如实展示。\r\n\r\n**数字格式规范：** ≥1万用 `w`（如 3.2w），≥1亿用 `亿`（如 1.5亿），<1万用千分位逗号（如 8,642）。\r\n\r\n**链接列格式：** 有url时显示 `[链接](url)`，无url时显示 `-`。\r\n\r\n**昵称链接格式：** 昵称字段使用 `[nickname](https://www.douyin.com/user/{secUid})` 格式，secUid 为空时显示纯文本。\r\n\r\n```markdown\r\n## 🎬 [nickname] - 抖音作品数据\r\n\r\n### 账号基础信息\r\n\r\n| 昵称 | 抖音号 | UID | 地域 | 粉丝数 | 获赞 | 作品总数 | 红狐指数 |\r\n|------|--------|-----|------|--------|------|---------|---------|\r\n| [nickname](https://www.douyin.com/user/[secUid]) | [accountId] | [uid] | [province·city] | [followerCount] | [totalFavorited] | [awemeCount] | [redfoxIndex] |\r\n\r\n---\r\n\r\n### 近期作品（共[N]条）\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n|---|---------|------|------|------|------|------|------|\r\n| 1 | [publishTime] | [title] | [likeCount] | [commentCount] | [shareCount] | [interactiveCount] | [链接](url) / - |\r\n\r\n> 作品列表为近期作品数据，最多50条（按发布时间倒序），账号历史作品总数为 [awemeCount] 条。\r\n\r\n---\r\n\r\n### 数据亮点\r\n\r\n#### 互动量TOP3\r\n\r\n🥇 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥈 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥉 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n\r\n#### 账号特征分析\r\n\r\n- **更新频率：** [基于近期作品发布间隔分析]\r\n- **内容方向：** [基于作品标题关键词归纳内容赛道]\r\n- **互动表现：** [基于互动数据整体趋势分析]\r\n- **爆款特征：** [基于TOP3作品共性总结]\r\n\r\n---\r\n\r\n### 数据说明\r\n\r\n- **数据范围：** 近期作品数据，最多50条，按发布时间倒序\r\n- **作品链接：** 接口返回url字段，提供作品直达链接；url为空时显示\"-\"\r\n- **数字格式：** ≥1万显示为x.xw（如3.2w），≥1亿显示为x.x亿，<1万用千分位逗号\r\n- **数据来源：** 红狐数据API\r\n\r\n*爬取时间：[YYYY-MM-DD HH:mm]*\r\n```\r\n\r\n---\r\n\r\n## 4. 脚本调用\r\n\r\n**查询账号作品：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n```\r\n\r\n**提交账号收录：**\r\n```bash\r\npython3 scripts/douyin_works_fetcher.py --account \"任意\" --sync \"抖音号\"\r\n```\r\n\r\n**参数说明：**\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--account` | 抖音昵称或抖音号（自动识别：含中文→昵称，非中文→抖音号） |\r\n| `--output` | 输出格式：`markdown`（默认）/ `json` |\r\n| `--sync` | 提交账号收录，传入抖音号触发异步同步 |\r\n\r\n**自动识别逻辑：**\r\n- 输入含中文 → 使用 `accountName` 参数查询（昵称模糊匹配）\r\n- 输入非中文 → 使用 `accountId` 参数查询（抖音号精准匹配）\r\n\r\n---\r\n\r\n## 5. 注意事项\r\n\r\n- 🔌 **唯一数据源：** 所有数据仅从红狐API获取，不使用第三方渠道补充或估算\r\n- 📊 **数据范围：** 近期作品数据，最多50条，非账号全部历史作品\r\n- 🔢 **数字格式：** ≥1万显示为 `x.xw`（如3.2w），≥1亿显示为 `x.x亿`，<1万用千分位逗号（如8,642）\r\n- 🔗 **作品链接：** 接口返回url字段，表格中显示为 `[链接](url)`，无url时显示 `-`\r\n- ❌ **未查询到账号：** API返回空数据时，输出账号收录提示文案，引导用户回复抖音号进行账号收录，**严禁联网搜索、严禁生成无依据报告**\r\n- 📥 **账号收录：** 用户回复抖音号后，调用 `POST /dyUser/syncUserNotes` 接口提交收录请求，约30分钟后可再次查询\r\n- ❌ **昵称匹配到错误账号：** 提示用户当前匹配结果非目标账号，引导提供抖音号重新查询，**严禁联网搜索**\r\n- ✅ **如实输出：** 作品数量如实展示\n\nFile v1.0.0:README.en.md\n\n# Douyin Works Crawler / douyin-works-crawler\r\n\r\n---\r\n\r\n## Overview\r\n\r\nA Douyin content data retrieval tool. Enter a Douyin nickname or ID to instantly fetch account basic info and recent works (up to 50 items), including engagement data and direct video links—plus a TOP 3 engagement analysis and account feature summary to help you quickly understand the target account's content performance.\r\n\r\n**Core Value**\r\n\r\n- **One-click works retrieval**: Enter a nickname or Douyin ID to automatically fetch account basic info (followers, total likes, total works, RedFox Index) and recent work lists.\r\n- **Auto data highlight analysis**: TOP 3 engagement works analysis + account feature summary (posting frequency, content direction, engagement trends, viral patterns)—quickly identify content worth learning from.\r\n- **Direct work links**: Each work comes with a direct link—click to jump to the original video.\r\n- **One-click unlisted account submission**: For accounts not yet indexed, reply with the Douyin ID to submit for indexing—data auto-syncs in about 30 minutes.\r\n\r\n**Intended Users**\r\n\r\n- 🏢 **Brands / marketing managers** — Monitor competitor Douyin account content performance and engagement data.\r\n- 🛍️ **MCN / operations staff** — Quickly evaluate creator account data performance and content direction.\r\n- 📝 **Douyin content creators** — Learn viral content patterns from top accounts in your niche.\r\n- 📊 **Data analysts** — Batch-fetch structured data for analysis reports.\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Account info query**: Enter a Douyin nickname or ID to instantly fetch account basic data (followers, total likes, total works, RedFox Index, etc.).\r\n- **Recent works retrieval**: Automatically fetch recent works (up to 50 items), including likes, comments, shares, engagement counts, and direct work links.\r\n- **Data highlight analysis**: Output TOP 3 engagement works analysis + account feature analysis (posting frequency, engagement trends, viral patterns).\r\n\r\n### Highlights\r\n\r\n- **Smart recognition**: Automatically detects input type (nickname/ID)—Chinese input uses nickname search, non-Chinese uses precise ID search.\r\n- **Account indexing**: Unlisted accounts support one-click indexing submission—data auto-syncs in about 30 minutes.\r\n- **Direct links**: Nickname links to account homepage; each work provides a direct video link.\r\n- **Safe & secure**: Data service-based access—no Douyin account login required.\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`)\r\n- Register at [RedFoxHub](https://redfox.hk?souce=github) to obtain `REDFOX_API_KEY`.\r\n- Configure `REDFOX_API_KEY` on your device before using this skill.\r\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\r\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe your query needs in natural language—no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent | Example phrase | Result |\r\n| ------ | -------------- | ------ |\r\n| Query account works | \"Crawl Douyin works for 周幺姑家常菜\" | Fetch account basic info + recent work list + data highlight analysis |\r\n| Precise query | \"Query works for Douyin ID cdjjc028\" | Precise ID match, avoiding nickname ambiguity |\r\n| Submit account indexing | \"My account can't be found, Douyin ID is 1212_1234\" | Submit indexing request; query again in ~30 minutes |\r\n| Export data | \"Export works data for 周幺姑家常菜\" | Get structured works data |\r\n\r\n### Output Example\r\n\r\nAfter querying, you will receive the following structured results:\r\n\r\n**Account Basic Info**: Nickname (clickable to homepage), Douyin ID, region, followers, total likes, total works, RedFox Index\r\n\r\n**Recent Works List** (up to 50 items, reverse chronological):\r\n\r\n| # | Publish Time | Title | Likes | Comments | Shares | Engagement | Link |\r\n| … | … | … | … | … | … | … | Clickable to original video |\r\n\r\n**Data Highlights**: TOP 3 engagement works analysis + Account features (posting frequency, content direction, engagement trends, viral patterns)\r\n\r\n---\r\n\r\n(When no data is found, the system guides you to reply with a Douyin ID for indexing—data syncs in ~30 minutes.)\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario | Role | Example question | Benefit |\r\n| -------- | ---- | ---------------- | ------- |\r\n| Brand competitor monitoring | Brand marketing manager | \"Check the works data and engagement of this competitor Douyin account for me\" | Stay on top of competitor content trends; optimize your own strategy |\r\n| MCN creator evaluation | MCN operations staff | \"Show me this creator's followers, likes, and recent works data\" | Quickly evaluate creator value; support signing decisions |\r\n| Content optimization learning | Douyin creator | \"Check the works of top accounts in my niche and analyze viral patterns\" | Find content optimization directions; boost account engagement |\r\n| Data analysis reports | Data analyst | \"Export works data for these Douyin accounts for analysis\" | Efficiently fetch structured data to support analysis reports |\r\n\r\n---\r\n\r\n## Important Data Notes\r\n\r\n- The work list shows recent works only—up to 50 items in reverse chronological order, not the account's full historical works.\r\n- Number formatting: ≥10k displays as `x.xw` (e.g., 3.2w), ≥100M displays as `x.x亿`; <10k uses comma separators.\r\n- Douyin nicknames are not unique; nickname queries may return fuzzy matches—use Douyin ID for precise lookup.\r\n- Unlisted accounts can be submitted for indexing; data auto-syncs in about 30 minutes.\r\n- All data comes exclusively from the data platform; no third-party supplementation or estimation.\r\n\r\n---\n\nFile v1.0.0:skill-card.md\n\n## Description: <br>\n抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。 <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[redfox-data](https://clawhub.ai/user/redfox-data) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users such as brands, MCN operators, content creators, and data analysts use this skill to retrieve Douyin account basics, recent works, engagement metrics, and direct work links for content analysis. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: User-provided Douyin account names or IDs and the REDFOX_API_KEY are sent to redfox.hk. <br>\nMitigation: Keep the API key in environment variables, do not expose it in prompts, code, logs, or output files, and confirm authorization before monitoring accounts at scale. <br>\nRisk: Nickname lookup can return a fuzzy match for a different Douyin account. <br>\nMitigation: Prefer precise Douyin IDs and verify the returned account before relying on the report. <br>\nRisk: Submitting an unlisted account can trigger later provider-side indexing. <br>\nMitigation: Submit account indexing only when authorized and explain that data may become available after provider synchronization. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/redfox-data/douyin-works-crawler) <br>\n- [Core workflow](references/core_workflow.md) <br>\n- [RedFox API](https://redfox.hk) <br>\n- [Douyin works query endpoint](https://redfox.hk/story/api/dyData/queryUserWithWorks) <br>\n- [Douyin account indexing endpoint](https://redfox.hk/dyUser/syncUserNotes) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Markdown, JSON, Shell commands, Configuration, Guidance] <br>\n**Output Format:** [Markdown report by default, with optional JSON output and command-line usage guidance] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Includes account basics, up to 50 recent works, engagement metrics, direct links, TOP3 engagement analysis, and account feature summaries.] <br>\n\n## Skill Version(s): <br>\n1.0.0 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: 抖音作品爬取 Owner: redfox-data Summary: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-08-06T02:30:59.109Z | auto - Removed账号收录相关功能及说明，精简功能范围，仅保留账号信息与近期作品爬取（最多50条）。 - 相应删除命令速查与文档中涉及账号收录的命令与流程。 - 更新和简化项目说明文档，包括安装、使用指南和常见问答，移除收录相关内容与说明。 - 删除 skill-card.md 文件，不再包含该描述文件。 - 保持主程序及接口调用说明一致，仅保留基础信息获取与内容采集功能。 v1.0.2 | 2","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: douyin-works-crawler\r\ndescription: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。\r\n---\r\n\r\n# 抖音作品爬取\r\n\r\n> 输入抖音名称或ID，一键获取账号基础信息 + 近期作品内容\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品爬取是一款专为抖音内容分析打造的智能工具，帮助用户快速获取任意抖音账号的基础信息和近期作品数据。\r\n\r\n通过简单的账号名称或抖音号输入，你可以：\r\n- 📊 获取账号基础信息（粉丝数、获赞、作品总数、红狐指数等）\r\n- 📋 查看近期作品列表（最多50条，含互动数据和作品链接）\r\n- 🔍 发现互动TOP3作品，获取值得学习的内容分析\r\n\r\n适用于品牌方、MCN机构、内容运营、自媒体从业者等需要分析抖音账号表现的场景。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 🎯 核心功能\r\n\r\n- **📊 账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）\r\n- **📋 近期作品爬取**：自动获取近期作品列表（最多50条），包含点赞、评论、分享、互动数及作品链接\r\n- **🔍 数据亮点分析**：互动量TOP3作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 智能识别**：自动判断输入类型（昵称/抖音号），无需手动切换查询模式\r\n- **🔗 直达链接**：昵称跳转账号主页，作品列表跳转视频页面\r\n- **🔒 安全可靠**：API 接入方式，无需登录抖音账号\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.6+\r\n- 红狐数据API密钥（格式 `ak_xxx`）\r\n\r\n### 安装方式\r\n\r\n#### 方式一：直接使用（推荐）\r\n\r\n1. 确保项目文件已下载到本地\r\n2. 配置环境变量：\r\n   ```bash\r\n   # macOS/Linux\r\n   export REDFOX_API_KEY=你的API密钥值\r\n\r\n   # Windows PowerShell\r\n   $env:REDFOX_API_KEY=\"你的API密钥值\"\r\n   ```\r\n3. 运行查询：\r\n   ```bash\r\n   python scripts/douyin_works_fetcher.py --account \"抖音名称或抖音号\"\r\n   ```\r\n\r\n#### 方式二：在 Coze/Dify 等平台配置\r\n\r\n1. 将技能文件夹上传至平台\r\n2. 在环境变量中配置 `REDFOX_API_KEY`\r\n3. 配置触发词，即可通过对话调用\r\n\r\n### 环境变量配置\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐数据API密钥（格式 `ak_xxx`） |\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 1. 查询账号作品\r\n\r\n告诉助手你想查询的抖音账号：\r\n\r\n> 用户：爬取\"周幺姑家常菜\"的抖音作品\r\n>\r\n> 助手：已为您查询到「周幺姑家常菜」的账号数据，粉丝547.1w，近期47条作品...\r\n\r\n#### 2. 精准查询（推荐）\r\n\r\n使用抖音号进行精准查询，避免昵称模糊匹配：\r\n\r\n> 用户：帮我查询抖音号 cdjjc028 的作品\r\n>\r\n> 助手：已精准匹配到「周幺姑家常菜」的账号数据...\r\n\r\n### 高级使用\r\n\r\n#### 4. 导出JSON格式\r\n\r\n需要结构化数据时，可指定JSON输出：\r\n\r\n```bash\r\npython scripts/douyin_works_fetcher.py --account \"抖音号\" --output json\r\n```\r\n\r\n### 命令速查\r\n\r\n| 命令 | 功能 |\r\n|------|------|\r\n| `爬取抖音作品 [名称/抖音号]` | 查询账号作品数据 |\r\n| `抖音作品列表 [名称/抖音号]` | 获取近期作品列表 |\r\n| `抖音内容采集 [名称/抖音号]` | 采集账号内容 |\r\n| `导出抖音作品 [名称/抖音号]` | 导出作品数据 |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：品牌方竞品监测\r\n\r\n**角色**：品牌营销经理\r\n\r\n**需求**：监测竞品抖音账号的内容表现和互动数据\r\n\r\n**使用方式**：\r\n1. 输入竞品账号的抖音号进行查询\r\n2. 查看近期作品列表和互动数据\r\n3. 分析互动TOP3作品的内容特征\r\n\r\n**预期收益**：及时掌握竞品内容动态，优化自身内容策略\r\n\r\n---\r\n\r\n### 场景二：MCN 机构达人评估\r\n\r\n**角色**：MCN 运营人员\r\n\r\n**需求**：评估达人账号的数据表现和内容方向\r\n\r\n**使用方式**：\r\n1. 查询目标达人的账号基础信息（粉丝数、获赞、红狐指数）\r\n2. 分析近期作品的互动表现\r\n3. 查看账号特征分析，了解更新频率和内容方向\r\n\r\n**预期收益**：快速评估达人价值，辅助签约决策\r\n\r\n---\r\n\r\n### 场景三：自媒体内容优化\r\n\r\n**角色**：抖音内容创作者\r\n\r\n**需求**：学习同领域头部账号的爆款内容特征\r\n\r\n**使用方式**：\r\n1. 查询同领域头部账号的作品数据\r\n2. 查看互动TOP3作品的分析\r\n3. 学习爆款内容值得借鉴的点\r\n\r\n**预期收益**：找到内容优化方向，提升账号互动表现\r\n\r\n---\r\n\r\n### 场景四：数据分析报告\r\n\r\n**角色**：数据分析师\r\n\r\n**需求**：批量获取抖音账号的结构化数据用于分析\r\n\r\n**使用方式**：\r\n1. 使用 `--output json` 参数导出结构化数据\r\n2. 批量查询多个账号\r\n3. 结合其他数据进行综合分析\r\n\r\n**预期收益**：高效获取数据，支撑分析报告输出\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\ndouyin-works-crawler/\r\n├── scripts/\r\n│   └── douyin_works_fetcher.py   # 核心脚本（API调用+数据格式化）\r\n├── references/\r\n│   └── core_workflow.md          # 核心技能逻辑（接口规范、输出模板、处理规则）\r\n├── CONFIG.json                   # 技能配置文件\r\n└── SKILL.md                      # 技能说明文档\r\n```\r\n\r\n### 技术栈\r\n\r\n| 项目 | 说明 |\r\n|------|------|\r\n| 运行环境 | Python 3.6+ |\r\n| 数据来源 | 红狐数据API |"},{"path":"README.md","content":"# 抖音作品爬取 / douyin-works-crawler\r\n\r\n---\r\n\r\n## 简介\r\n\r\n抖音作品数据获取工具，输入抖音昵称或抖音号，一键获取账号基础信息与近期作品内容列表（最多 50 条），含互动数据和作品直达链接，并提供互动 TOP3 分析与账号特征总结，帮助用户快速掌握目标账号的内容表现。\r\n\r\n**核心价值**\r\n\r\n- **一键获取作品数据**：输入昵称或抖音号，自动获取账号粉丝数、获赞、作品总数等基础信息及近期作品列表。\r\n- **数据亮点自动分析**：互动量 TOP3 作品分析 + 账号特征总结（更新频率、内容方向、互动表现、爆款特征），快速发现值得学习的内容。\r\n- **作品直达链接**：每条作品提供直达链接，点击即可跳转查看原视频。\r\n\r\n**适用对象**\r\n\r\n- 🏢 **品牌方 / 营销经理** — 监测竞品抖音账号的内容表现和互动数据。\r\n- 🛍️ **MCN / 运营人员** — 快速评估达人账号的数据表现和内容方向。\r\n- 📝 **抖音内容创作者** — 学习同领域头部账号的爆款内容特征。\r\n- 📊 **数据分析师** — 批量获取结构化数据用于分析报告。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **账号信息查询**：输入抖音昵称或抖音号，一键获取账号基础数据（粉丝数、获赞、作品总数、红狐指数等）。\r\n- **近期作品获取**：自动获取近期作品列表（最多 50 条），包含点赞、评论、分享、互动数及作品直达链接。\r\n- **数据亮点分析**：输出互动量 TOP3 作品分析 + 账号特征分析（更新频率、互动表现、爆款特征）。\r\n\r\n### 特色亮点\r\n\r\n- **智能识别**：自动判断输入类型（昵称/抖音号），含中文走昵称查询，非中文走抖音号精准查询。\r\n- **直达链接**：昵称可跳转账号主页，每条作品提供直达链接。\r\n- **安全可靠**：通过数据服务接入，无需登录抖音账号。\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=clawhub) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言描述查询需求，无需记忆命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图 | 示例话术 | 效果 |\r\n| ---- | -------- | ---- |\r\n| 查询账号作品 | 「爬取周幺姑家常菜的抖音作品」 | 获取账号基础信息 + 近期作品列表 + 数据亮点分析 |\r\n| 精准查询 | 「帮我查询抖音号 cdjjc028 的作品」 | 按抖音号精准匹配，避免昵称模糊 |\r\n| 导出数据 | 「导出周幺姑家常菜的作品数据」 | 获取结构化作品数据 |\r\n\r\n### 输出示例\r\n\r\n完成查询后，你将收到以下结构化的结果：\r\n\r\n**账号基础信息**：昵称（可点击跳转主页）、抖音号、地域、粉丝数、获赞、作品总数、红狐指数\r\n\r\n**近期作品列表**（最多 50 条，按发布时间倒序）：\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n| … | … | … | … | … | … | … | 可点击跳转原视频 |\r\n\r\n**数据亮点**：互动量 TOP3 作品分析 + 账号特征（更新频率、内容方向、互动表现、爆款特征）\r\n\r\n---\r\n\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| ---- | ---- | -------- | ---- |\r\n| 品牌竞品监测 | 品牌营销经理 | 「帮我查一下竞品抖音号的作品数据和互动表现」 | 及时掌握竞品内容动态，优化自身策略 |\r\n| MCN 达人评估 | MCN 运营人员 | 「帮我看看这个达人的粉丝数、获赞和近期作品数据」 | 快速评估达人价值，辅助签约决策 |\r\n| 内容优化学习 | 抖音创作者 | 「帮我查同领域头部账号的作品，分析爆款特征」 | 找到内容优化方向，提升账号互动表现 |\r\n| 数据分析报告 | 数据分析师 | 「帮我导出这几个抖音号的作品数据做分析」 | 高效获取结构化数据，支撑分析报告 |\r\n\r\n---\r\n\r\n## 重要数据说明\r\n\r\n- 作品列表为近期作品数据，最多 50 条，按发布时间倒序排列，非账号全部历史作品。\r\n- 数字格式：≥1 万显示为 `x.xw`（如 3.2w），≥1 亿显示为 `x.x亿`，<1 万用千分位逗号。\r\n- 抖音昵称不唯一，用昵称查询可能返回模糊匹配结果，建议用抖音号进行精准查询。\r\n- 所有数据唯一来源为数据平台，不会从第三方渠道补充或估算。\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n\r\n---"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n  \"slug\": \"douyin-works-crawler\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1785983459109\n}"},{"path":"references/core_workflow.md","content":"# 核心技能逻辑\r\n\r\n> 本文件为 douyin-works-crawler 技能的完整执行逻辑参考，SKILL.md 通过引用本文件获取详细规则。\r\n\r\n---\r\n\r\n## 1. 数据来源\r\n\r\n**唯一数据源：红狐数据API**\r\n\r\n### 1.1 查询接口\r\n\r\n| 配置项 | 值 |\r\n|--------|-----|\r\n| 接口地址 | `POST https://redfox.hk/story/api/dyData/queryUserWithWorks` |\r\n| 认证 | 请求头 `X-API-KEY`（环境变量 `REDFOX_API_KEY`，格式 `ak_xxx`） |\r\n| 积分 | 是（resourceId: `/story/api/dyData/queryUserWithWorks`） |\r\n\r\n**请求参数：**\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| `accountId` | String | 否* | 抖音号/uid（支持 unique_id、short_id、uid 任一匹配） |\r\n| `accountName` | String | 否* | 作者/账号名 |\r\n| `source` | String | 否 | 调用来源（默认：抖音作品抓取-GitHub） |\r\n\r\n> *accountId和accountName至少传一个\r\n\r\n> **查询精准度提醒：** 抖音昵称不唯一，使用accountName可能返回首个模糊匹配账号。若需精准查询，建议使用accountId（抖音号）。\r\n\r\n**响应字段：**\r\n\r\n- 账号级：nickname / accountId / uniqueId / uid / secUid / province / city / ipLocation / followerCount / awemeCount / totalFavorited / redfoxIndex\r\n- 作品级（workList，近期作品数据，最多50条，按发布时间倒序）：title / likeCount / commentCount / shareCount / interactiveCount / publishTime / url\r\n\r\n**数据范围说明：**\r\n\r\n- API返回的 `workList` 为**近期作品数据，最多50条**，按发布时间倒序排列\r\n- 实际返回数量取决于账号发布频率，通常为 1~50 条\r\n- `awemeCount` 字段为账号历史作品**总数**，workList中的数量可能小于该值\r\n- 若账号近期无作品或暂无数据，workList 为空列表\r\n\r\n\r\n## 2. 查询未命中处理\r\n\r\n当查询未找到目标账号时，**严禁联网搜索**，按以下流程处理：\r\n\r\n1. **匹配到错误账号** → 提示：\"昵称查询返回的是「[实际匹配的昵称]」，非您要找的账号。请提供目标账号的**抖音号**进行精准查询。\"\r\n2. **未查询到账号** → 输出提示信息：\r\n\r\n```\r\n未查询到当前账号的相关信息，请检查输入的抖音号或昵称是否正确。\r\n建议使用抖音号进行精准查询，或稍后再试。\r\n```\r\n\r\n### 降级策略\r\n\r\nAPI调用失败（如积分不足、网络异常）时明确告知用户错误原因，**严禁联网搜索、严禁从第三方渠道估算或补充API未返回的字段**。\r\n\r\n---\r\n\r\n## 3. 输出模板\r\n\r\n**使用说明：** 严格按模板输出，不可省略章节。数据来源于API，如实展示。\r\n\r\n**数字格式规范：** ≥1万用 `w`（如 3.2w），≥1亿用 `亿`（如 1.5亿），<1万用千分位逗号（如 8,642）。\r\n\r\n**链接列格式：** 有url时显示 `[链接](url)`，无url时显示 `-`。\r\n\r\n**昵称链接格式：** 昵称字段使用 `[nickname](https://www.douyin.com/user/{secUid})` 格式，secUid 为空时显示纯文本。\r\n\r\n```markdown\r\n## 🎬 [nickname] - 抖音作品数据\r\n\r\n### 账号基础信息\r\n\r\n| 昵称 | 抖音号 | UID | 地域 | 粉丝数 | 获赞 | 作品总数 | 红狐指数 |\r\n|------|--------|-----|------|--------|------|---------|---------|\r\n| [nickname](https://www.douyin.com/user/[secUid]) | [accountId] | [uid] | [province·city] | [followerCount] | [totalFavorited] | [awemeCount] | [redfoxIndex] |\r\n\r\n---\r\n\r\n### 近期作品（共[N]条）\r\n\r\n| # | 发布时间 | 标题 | 点赞 | 评论 | 分享 | 互动 | 链接 |\r\n|---|---------|------|------|------|------|------|------|\r\n| 1 | [publishTime] | [title] | [likeCount] | [commentCount] | [shareCount] | [interactiveCount] | [链接](url) / - |\r\n\r\n> 作品列表为近期作品数据，最多50条（按发布时间倒序），账号历史作品总数为 [awemeCount] 条。\r\n\r\n---\r\n\r\n### 数据亮点\r\n\r\n#### 互动量TOP3\r\n\r\n🥇 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥈 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n🥉 **[title]**（互动[interactiveCount]）\r\n> [根据账号数据、作品内容、内容定位等总结该作品值得学习点]\r\n\r\n\r\n#### 账号特征分析\r\n\r\n- **更新频率：** [基于近期作品发布间隔分析]\r\n- **内容方向：** [基于作品标题关键词归纳内容赛道]\r\n- **互动表现：** [基于互动数据整体趋势分析]\r\n- **爆款特征：** [基于TOP3作品共性总结]\r\n\r\n---\r\n\r\n### 数据说明\r\n\r\n- **数据范围：** 近期作品数据，最多50条，按发布时间倒序\r\n- **作品链接：** 接口返回url字段，提供作品直达链接；url为空时显示\"-\"\r\n- **数字格式：** ≥1万显示为x.xw（如3.2w），≥1亿显示为x.x亿，<1万用千分位逗号\r\n- **数据来源：** 红狐数据API\r\n\r\n*爬取时间：[YYYY-MM-DD HH:mm]*\r\n> 💼 另外红狐配套全量数据库可"},{"path":"README.en.md","content":"# Douyin Works Crawler / douyin-works-crawler\r\n\r\n---\r\n\r\n## Overview\r\n\r\nA Douyin content data retrieval tool. Enter a Douyin nickname or ID to instantly fetch account basic info and recent works (up to 50 items), including engagement data and direct video links—plus a TOP 3 engagement analysis and account feature summary to help you quickly understand the target account's content performance.\r\n\r\n**Core Value**\r\n\r\n- **One-click works retrieval**: Enter a nickname or Douyin ID to automatically fetch account basic info (followers, total likes, total works, RedFox Index) and recent work lists.\r\n- **Auto data highlight analysis**: TOP 3 engagement works analysis + account feature summary (posting frequency, content direction, engagement trends, viral patterns)—quickly identify content worth learning from.\r\n- **Direct work links**: Each work comes with a direct link—click to jump to the original video.\r\n\r\n**Intended Users**\r\n\r\n- 🏢 **Brands / marketing managers** — Monitor competitor Douyin account content performance and engagement data.\r\n- 🛍️ **MCN / operations staff** — Quickly evaluate creator account data performance and content direction.\r\n- 📝 **Douyin content creators** — Learn viral content patterns from top accounts in your niche.\r\n- 📊 **Data analysts** — Batch-fetch structured data for analysis reports.\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Account info query**: Enter a Douyin nickname or ID to instantly fetch account basic data (followers, total likes, total works, RedFox Index, etc.).\r\n- **Recent works retrieval**: Automatically fetch recent works (up to 50 items), including likes, comments, shares, engagement counts, and direct work links.\r\n- **Data highlight analysis**: Output TOP 3 engagement works analysis + account feature analysis (posting frequency, engagement trends, viral patterns).\r\n\r\n### Highlights\r\n\r\n- **Smart recognition**: Automatically detects input type (nickname/ID)—Chinese input uses nickname search, non-Chinese uses precise ID search.\r\n- **Direct links**: Nickname links to account homepage; each work provides a direct video link.\r\n- **Safe & secure**: Data service-based access—no Douyin account login required.\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)\r\n- Register at [RedFoxHub](https://redfox.hk?source=clawhub) to obtain `REDFOX_API_KEY`.\r\n- Configure `REDFOX_API_KEY` on your device before using this skill.\r\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\r\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe your query needs in natural language—no commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent | Example phrase | Result |\r\n| ------ | -------------- | ------ |\r\n| Quer"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。 Skill: 抖音作品爬取 Owner: redfox-data Summary: 抖音作品爬取工具，输入抖音名称或抖音ID，输出抖音账号基础信息和近期作品内容列表（最多50条）。当用户提到\"爬取抖音作品\"、\"抖音作品列表\"、\"查看抖音视频\"、\"抖音内容采集\"、\"抓取抖音作品\"时使用。 Tags: latest:1.0.3 Version history: v1.0.3 | 2026-08-06T02:30:59.109Z | auto - Removed账号收录相关功能及说明，精简功能范围，仅保留账号信息与近期作品爬取（最多50条）。 - 相应删除命令速查与文档中涉及账号收录的命令与流程。 - 更新和简化项目说明文档，包括安装、使用指南和常见问答，移除收录相关内容与说明。 - 删除 skill-card.md 文件，不再包含该描述文件。 - 保持主程序及接口调用说明一致，仅保留基础信息获取与内容采集功能。 v1.0.2 | 2","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":938,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:58:17.168Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T14:58:17.168Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:43:05.133Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}