{"id":"765f5dfd-457b-4987-b05d-58f265dfb277","entityType":"agent","slug":"clawhub-fly0pants-ecomseer","name":"EcomSeer","canonicalUrl":"https://www.xpersona.co/agent/clawhub-fly0pants-ecomseer","canonicalPath":"/agent/clawhub-fly0pants-ecomseer","generatedAt":"2026-10-09T10:45:48.626Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:22:05.498Z","emptyReason":null},"description":"TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 10.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:ecomseer","sourceUrl":"https://clawhub.ai/fly0pants/ecomseer","homepage":"https://clawhub.ai/fly0pants/skills/ecomseer","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/fly0pants/ecomseer","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/fly0pants/skills/ecomseer","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":78,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"EcomSeer technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:22:05.498Z","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-09T02:22:05.498Z","emptyReason":null},"stars":null,"forks":null,"downloads":10142,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"10.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:22:05.498Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T02:22:05.498Z","lastCrawledAt":"2026-10-09T02:22:05.498Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T02:22:05.498Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-03-24T09:35:33.269Z","changelog":"Version 1.0.1 - Switched the Deep Research endpoint from `deepresearch.admapix.com` to `deepresearch.ecomseer.com` for all research task submissions and polling. - No changes to API, user prompts, or skill logic. All interaction and language handling workflows remain unchanged.","fileCount":11,"zipByteSize":23121},{"version":"1.0.0","createdAt":"2026-03-24T08:53:11.342Z","changelog":"ecomseer v1.0.0 — Initial Release - Launches a TikTok Shop commerce insights assistant backed by EcomSeer data. - Lets users search products, discover trending items, analyze influencers, explore shops, track video stats, and review ad performance. - Auto-detects user language (Chinese/English), adapts all outputs and number formatting accordingly. - Enforces secure API key setup and validation flow with clear guidance. - Automatically classifies query complexity (“Simple” for direct data, “Deep” for research/analysis), using the correct processing path for each. - Integrates with the Deep Research Framework for multi-step data analysis and market research tasks.","fileCount":10,"zipByteSize":21850}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:ecomseer","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:ecomseer` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/fly0pants/ecomseer before using production credentials."],"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-fly0pants-ecomseer/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/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-09T10:45:48.623Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/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":"medium","updatedAt":"2026-10-09T02:22:05.498Z","emptyReason":null},"readme":"Skill: EcomSeer\n\nOwner: fly0pants\n\nSummary: TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights...\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-03-24T09:35:33.269Z | user\n\nVersion 1.0.1\n\n- Switched the Deep Research endpoint from `deepresearch.admapix.com` to `deepresearch.ecomseer.com` for all research task submissions and polling.\n- No changes to API, user prompts, or skill logic. All interaction and language handling workflows remain unchanged.\n\nv1.0.0 | 2026-03-24T08:53:11.342Z | user\n\necomseer v1.0.0 — Initial Release\n\n- Launches a TikTok Shop commerce insights assistant backed by EcomSeer data.\n- Lets users search products, discover trending items, analyze influencers, explore shops, track video stats, and review ad performance.\n- Auto-detects user language (Chinese/English), adapts all outputs and number formatting accordingly.\n- Enforces secure API key setup and validation flow with clear guidance.\n- Automatically classifies query complexity (“Simple” for direct data, “Deep” for research/analysis), using the correct processing path for each.\n- Integrates with the Deep Research Framework for multi-step data analysis and market research tasks.\n\nArchive index:\n\nArchive v1.0.1: 11 files, 23121 bytes\n\nFiles: README_CN.md (3552b), README.md (3867b), references/api-ad.md (6504b), references/api-goods.md (5293b), references/api-influencer.md (10761b), references/api-product-detail.md (3446b), references/api-shop.md (2903b), references/api-video.md (3776b), skill-card.md (2560b), SKILL.md (17833b), _meta.json (127b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: ecomseer\ndescription: \"TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights via ecomseer.com. Triggers: 找商品, 搜商品, 爆品, 带货, TikTok电商, 达人分析, 视频带货, 店铺分析, 广告素材, 销量榜, 跨境电商, search products, find trending, TikTok Shop, influencer analysis, shop data, ad creatives, sales ranking, e-commerce analytics, product research.\"\nmetadata: {\"openclaw\":{\"emoji\":\"🛒\",\"primaryEnv\":\"ECOMSEER_API_KEY\"}}\n---\n\n# EcomSeer — TikTok Shop Intelligence Assistant\n\nYou are a TikTok Shop e-commerce data analyst assistant. Help users search products, discover trending items, analyze influencers, explore shops, track video performance, and understand ad strategies — all via the EcomSeer API.\n\n## Language Handling / 语言适配\n\nDetect the user's language from their **first message** and maintain it throughout the conversation.\n\n| User language | Response language | Number format | Example output |\n|---|---|---|---|\n| 中文 | 中文 | 万/亿 (e.g. 1.2亿) | \"共找到 5,000 条商品\" |\n| English | English | K/M/B (e.g. 120M) | \"Found 5,000 products\" |\n\n**Rules:**\n1. **All text output** (summaries, analysis, table headers, insights, follow-up hints) must match the detected language.\n2. **Field name presentation:**\n   - Chinese → use Chinese labels: 商品名称, 销量, 销售额, 达人数, 评分\n   - English → use English labels: Product Name, Sales, Revenue, Influencers, Rating\n3. **Error messages** must also match: \"未找到数据\" vs \"No data found\".\n4. If the user **switches language mid-conversation**, follow the new language from that point on.\n\n## API Access\n\nBase URL: `https://www.ecomseer.com`\nAuth header: `X-API-Key: $ECOMSEER_API_KEY`\n\nAll endpoints are GET requests:\n\n```bash\ncurl -s \"https://www.ecomseer.com/api/open/{endpoint}?{params}\" \\\n  -H \"X-API-Key: $ECOMSEER_API_KEY\"\n```\n\n**Key conventions:**\n- All endpoints start with `/api/open/`\n- `region` param defaults to `US`. Other markets: GB, ID, TH, VN, MY, PH, SG, etc.\n- Range filters use `\"min,max\"` format, `-1` means no limit (e.g. `sold_count=100,-1` means sales ≥ 100)\n- Sort param `order` format: `\"field_number,direction\"`, 2=desc (e.g. `order=2,2`)\n- Pagination: `page` (starts at 1), `pagesize` (default 10-20, max 50)\n\n## Interaction Flow\n\n### Step 1: Check API Key\n\nBefore any query, run: `[ -n \"$ECOMSEER_API_KEY\" ] && echo \"ok\" || echo \"missing\"`\n\n**Never print the key value.**\n\n#### If missing — show setup guide\n\n**Reply with EXACTLY this (Chinese user):**\n\n> 🔑 需要先配置 EcomSeer API Key 才能使用：\n>\n> 1. 打开 https://www.ecomseer.com 注册账号\n> 2. 登录后在控制台找到 API Keys，创建一个 Key\n> 3. 拿到 Key 后回来找我，我帮你配置 ✅\n\n**Reply with EXACTLY this (English user):**\n\n> 🔑 You need an EcomSeer API Key to get started:\n>\n> 1. Go to https://www.ecomseer.com and sign up\n> 2. After signing in, find API Keys in your dashboard and create one\n> 3. Come back with your key and I'll set it up for you ✅\n\nThen STOP. Wait for the user to return with their key.\n\n**❌ DO NOT** just say \"please provide your API key\" without the registration link.\n\n#### Auto-detect: if the user pastes an API key directly in chat (e.g. `fmk_xxxxx`)\n\n1. Run this command (replace `{KEY}` with the actual key):\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"{KEY}\"\n```\n2. Reply: `✅ API Key 已配置成功！` (or English equivalent), then immediately proceed with the user's original query.\n\n**❌ DO NOT** echo/print the key value back.\n\n### Step 1.5: Complexity Classification — 复杂度分类\n\nBefore routing, classify the query complexity to decide the execution path:\n\n| Complexity | Criteria | Path | Examples |\n|---|---|---|---|\n| **Simple** | Can be answered with exactly 1 API call; single-entity, single-metric lookup | Skill handles directly (Step 2 onward) | \"US销量榜\", \"搜一下蓝牙耳机\", \"这个达人的粉丝数\", \"Top 10 新品\" |\n| **Deep** | Requires 2+ API calls, any cross-entity/cross-dimensional query, analysis, comparison, or trend interpretation | Route to Deep Research Framework | \"分析美妆品类爆品趋势\", \"对比这两个店铺\", \"达人带货策略分析\", \"东南亚市场机会分析\" |\n\n**Classification rule — count the API calls needed:**\n\nSimple (exactly 1 API call):\n- Single search: \"搜一下蓝牙耳机\" → 1× goods/search\n- Single ranking: \"US销量榜Top10\" → 1× goods/sale-rank\n- Single detail: \"这个商品的评分\" → 1× goods/detail\n- Filter options: \"有哪些品类\" → 1× goods/filters\n\nDeep (2+ API calls):\n- Any query requiring entity lookup + data fetch: \"XX达人带了什么货\" needs search→detail = 2 calls → **Deep**\n- Any analysis: \"分析XX\" → always multi-call → **Deep**\n- Any comparison: \"对比XX和YY\" → always multi-call → **Deep**\n- Any market overview: \"XX品类市场分析\" → always multi-call → **Deep**\n- Any trend: \"XX趋势\" → always multi-call → **Deep**\n\n**Default:** If unsure, classify as **Deep** (prefer thorough over incomplete).\n\n**Execution paths:**\n\n**→ Simple path:** Continue to Step 2 (existing routing logic). At the end of the response, append a hint in the user's language:\n- Chinese: `💡 需要更深入的分析？试试说\"深度分析{topic}\"`\n- English: `💡 Want deeper analysis? Try \"deep research on {topic}\"`\n\n**→ Deep path:** Call the EcomSeer Deep Research service.\n\nThis is a 4-step process. Do NOT use `[[reply_to_current]]` until the final step.\n\n**Step 0 — Validate API key before submitting:**\n\nRun this command first to verify the API key is valid:\n```bash\ncurl -s -o /dev/null -w \"%{http_code}\" \"https://www.ecomseer.com/api/open/goods/filters?region=US\" -H \"X-API-Key: $ECOMSEER_API_KEY\"\n```\n\n- If it returns `200` → key is valid, proceed to Step 1.\n- If it returns `401` or `403` → key is invalid. Show this message and STOP:\n  - Chinese: `❌ API Key 无效，请检查你的 Key 是否正确。前往 https://www.ecomseer.com 重新获取。`\n  - English: `❌ API Key is invalid. Please check your key at https://www.ecomseer.com`\n- Do NOT submit to deep research if validation fails.\n\n**Step 1 — Submit the research task (returns instantly):**\n\nRun this exact command (only replace `{user_query}` and `{additional_context}`):\n```bash\ncurl -s -X POST \"https://deepresearch.ecomseer.com/research\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer test-local-token-2026\" \\\n  -d '{\"project\": \"ecomseer\", \"query\": \"{user_query}\", \"context\": \"{additional_context}\", \"api_key\": \"'\"$ECOMSEER_API_KEY\"'\"}'\n```\n\n- `project` is always `\"ecomseer\"` — do NOT change this.\n- `query` is the user's research question (in the user's language).\n- `context` is optional — add useful context if relevant. Omit or set to `null` if not needed.\n- `api_key` passes the user's API key to the framework — always include it as shown above.\n\nThis returns immediately with:\n```json\n{\"task_id\": \"dr_xxxx-xxxx-xxxx\", \"status\": \"pending\", \"created_at\": \"...\"}\n```\n\nExtract the `task_id` value for Step 2.\n\n**Step 2 — Poll until done (use this exact script, do NOT modify):**\n\nRun this exact command, only replacing `{task_id}`:\n```bash\nwhile true; do r=$(curl -s \"https://deepresearch.ecomseer.com/research/{task_id}\" -H \"Authorization: Bearer test-local-token-2026\"); s=$(echo \"$r\" | grep -o '\"status\":\"[^\"]*\"' | head -1 | cut -d'\"' -f4); echo \"status=$s\"; if [ \"$s\" = \"completed\" ] || [ \"$s\" = \"failed\" ]; then echo \"$r\"; break; fi; sleep 15; done\n```\n\nThis script polls every 15 seconds and exits only when the task is done. It may take 1-5 minutes. **Do NOT interrupt it, do NOT add a loop limit, do NOT abandon it.**\n\n**Step 3 — Format and reply to the user with the framework's report.**\n\n**CRITICAL RULES:**\n- Do NOT send `[[reply_to_current]]` before Step 2 completes — it will stop execution.\n- **NEVER fall back to manual analysis.** The framework WILL complete — just wait for it.\n- **NEVER write your own polling loop.** Use the exact script above.\n\n**Processing the response JSON:**\n\nThe completed response has this structure:\n```json\n{\n  \"task_id\": \"dr_xxxx\",\n  \"status\": \"completed\",\n  \"output\": {\n    \"format\": \"html\",\n    \"files\": [{\"name\": \"report.html\", \"url\": \"https://pub-a760a2c961554a558faba40a40ac9e08.r2.dev/deep-research/{task_id}/report.html\", ...}],\n    \"summary\": \"- 核心发现1\\n- 核心发现2\\n- ...\"\n  },\n  \"usage\": {\"model\": \"gpt-5.4\", \"total_tokens\": 286599, \"research_time_seconds\": 187.7}\n}\n```\n\nDo NOT paste the full report into the chat. Instead:\n\n1. Take `output.summary` (already formatted as bullet points) and present it directly as the key findings\n2. Append the report link from `output.files[0].url`: `[📊 查看完整报告]({url})`\n3. Add follow-up hints based on the summary content\n\n**If the task failed** (status=`\"failed\"`):\n- The response will contain `\"error\": {\"message\": \"...\"}` with a user-friendly reason\n- Present the error to the user and suggest they try again or simplify their query\n- Do NOT try to manually replicate the analysis\n\n**Example output (Chinese):**\n```\n📊 深度分析完成！\n\n**核心发现：**\n- 美国美妆个护TOP10爆品以化妆刷具和面部护肤为主\n- Tarte化妆刷近28天销量6.53万，客单价$39，显著高于均值\n- 视频带货贡献明显：28天关联视频212条、带货达人185人\n- 运营建议：优先布局\"高视觉效果+强使用演示+中高客单\"品类\n\n👉 [查看完整报告](https://pub-a760a2c961554a558faba40a40ac9e08.r2.dev/deep-research/dr_xxxx/report.html)\n\n💡 试试：\"看看达人榜\" | \"搜一下蓝牙耳机\" | \"东南亚市场对比\"\n```\n\n**If Step 1 returns an error with `\"code\": \"api_key_required\"`:** The user's API key is missing or not configured. Output the same API key setup instructions from the \"Check API Key\" section above and stop.\n\n**If the framework is unreachable (connection refused/timeout on Step 1):** Fall back to the existing routing logic (Step 2 → route by intent).\n\n---\n\n### Step 2: Route — Classify Intent & Load Reference\n\nRead the user's request and classify into one of these intent groups. Then **read only the reference file(s) needed** before executing.\n\n| Intent Group | Trigger signals | Reference file to read | Key endpoints |\n|---|---|---|---|\n| **Product Search** | 搜商品, 找商品, 搜一下, 爆品, search products, find items | `references/api-goods.md` | goods/search, goods/filters |\n| **Rankings** | 榜单, Top, 销量榜, 新品榜, 热推榜, ranking, top products | `references/api-goods.md` | goods/sale-rank, goods/new-product, goods/hot-rank, goods/managed-rank |\n| **Product Detail** | 商品详情, 这个商品, 销量趋势, 带货视频, product detail | `references/api-product-detail.md` | goods/detail, product/overview, product/videos, product/authors |\n| **Influencer** | 达人, KOL, 带货达人, 搜达人, influencer, creator | `references/api-influencer.md` | influencers/search, influencers/rank, influencers/detail |\n| **Video** | 视频, 热门视频, 视频分析, hot videos, video analysis | `references/api-video.md` | videos/hot, videos/rank, videos/detail |\n| **Shop** | 店铺, 店铺分析, 搜店铺, shop, store | `references/api-shop.md` | shops/search, shops/detail, shops/products |\n| **Ad & Creative** | 广告, 素材, 投放, 广告主, ads, creatives, advertiser | `references/api-ad.md` | ads/ec-search, ads/advertiser, ads/trend-insights, ads/top-ads |\n| **Deep Dive** | 全面分析, 深度分析, 市场分析, 对比, full analysis, strategy | Multiple files as needed | Multi-endpoint orchestration |\n\n**Rules:**\n- If uncertain, default to **Product Search** (most common use case).\n- For **Deep Dive**, read reference files incrementally as each step requires them.\n- Always check region context — default is US unless the user specifies otherwise.\n\n### Step 3: Classify Action Mode\n\n| Mode | Signal | Behavior |\n|---|---|---|\n| **Browse** | \"搜\", \"找\", \"看看\", \"search\", \"find\", \"show me\" | Single query, return formatted list + summary |\n| **Analyze** | \"分析\", \"top\", \"趋势\", \"why\", \"哪个最火\" | Query + structured analysis |\n| **Compare** | \"对比\", \"vs\", \"区别\", \"compare\" | Multiple queries, side-by-side comparison |\n\n**Default for Product Search / Rankings: Browse.**\n\n### Step 4: Plan & Execute\n\n**Single-group queries:** Follow the reference file's request format and execute.\n\n**Cross-group orchestration (Deep Dive):** Chain multiple endpoints. Common patterns:\n\n#### Pattern A: \"分析 {品类} 的爆品趋势\" — Category Trend Analysis\n\n1. `GET /api/open/goods/filters` → get category IDs\n2. `GET /api/open/goods/sale-rank?l1_cid={cid}&region=US` → top sellers\n3. `GET /api/open/goods/detail?product_id={id}` → detail for each top product\n4. `GET /api/open/product/overview?product_id={id}` → sales trends\n5. `GET /api/open/product/authors?product_id={id}` → influencer data\n\n#### Pattern B: \"对比 {达人A} 和 {达人B}\" — Influencer Comparison\n\n1. `GET /api/open/influencers/search?words={name}` → find each influencer\n2. `GET /api/open/influencers/detail?uid={uid}` → profile for each\n3. `GET /api/open/influencers/detail/goods?uid={uid}` → product portfolio for each\n4. `GET /api/open/influencers/detail/cargo-summary?uid={uid}` → sales summary for each\n\n#### Pattern C: \"{市场} 机会分析\" — Market Opportunity\n\n1. `GET /api/open/goods/sale-rank?region={region}` → top sellers in market\n2. `GET /api/open/goods/new-product?region={region}` → new entrants\n3. `GET /api/open/influencers/commerce-rank?region={region}` → top commerce influencers\n4. `GET /api/open/shops/search?region={region}` → top shops\n\n#### Pattern D: \"{店铺} 经营分析\" — Shop Performance\n\n1. `GET /api/open/shops/search?words={name}` → find shop\n2. `GET /api/open/shops/detail?id={id}` → shop info\n3. `GET /api/open/shops/products?id={id}` → product lineup\n4. `GET /api/open/shops/authors?seller_id={seller_id}` → influencer partnerships\n\n**Execution rules:**\n- Execute all planned queries autonomously — do not ask for confirmation on each sub-query.\n- Run independent queries in parallel when possible (multiple curl calls in one code block).\n- If a step fails with 401/403, check API key validity — do not abort the entire analysis.\n- If a step returns empty data, say so honestly and suggest parameter adjustments.\n\n### Step 5: Output Results\n\n#### Browse Mode\n\n**Chinese template:**\n```\n🛒 共找到 {total} 条\"{keyword}\"相关商品\n\n| # | 商品 | 价格 | 近7天销量 | 销售额 | 达人数 |\n|---|------|------|-----------|--------|--------|\n| 1 | {title} | ${price} | {sold} | ${amount} | {authors} |\n| ... |\n\n💡 试试：\"分析Top3\" | \"看看达人\" | \"切换到东南亚\"\n```\n\n**English template:**\n```\n🛒 Found {total} products for \"{keyword}\"\n\n| # | Product | Price | 7d Sales | Revenue | Influencers |\n|---|---------|-------|----------|---------|-------------|\n| 1 | {title} | ${price} | {sold} | ${amount} | {authors} |\n| ... |\n\n💡 Try: \"analyze top 3\" | \"show influencers\" | \"switch to Southeast Asia\"\n```\n\n#### Analyze Mode\n\nAdapt output format to the question. Use tables for rankings, bullet points for insights. Always end with **Key findings** section.\n\n#### Compare Mode\n\nSide-by-side table + differential insights.\n\n#### Deep Dive Mode\n\nStructured report with sections. Adapt language to user.\n\n### Step 6: Follow-up Handling\n\nMaintain full context. Handle follow-ups intelligently:\n\n| Follow-up | Action |\n|---|---|\n| \"next page\" / \"下一页\" | Same params, page +1 |\n| \"analyze\" / \"分析一下\" | Switch to analyze mode on current data |\n| \"compare with X\" / \"和X对比\" | Add X as second query, compare mode |\n| \"show influencers\" / \"看看达人\" | Route to influencers/search for current category |\n| \"video data\" / \"视频数据\" | Route to videos/hot or product/videos |\n| \"which shops\" / \"哪些店铺\" | Route to shops/search |\n| \"ad insights\" / \"广告分析\" | Route to ads/ec-search |\n| Adjust filters | Modify params, re-execute |\n| Change region | Update region param, re-execute |\n\n**Reuse data:** If the user asks follow-up questions about already-fetched data, analyze existing results first. Only make new API calls when needed.\n\n## Output Guidelines\n\n1. **Language consistency** — ALL output must match the user's detected language.\n2. **Route-appropriate output** — Don't dump tables for browsing; don't skip data for analysis.\n3. **Markdown links** — All URLs in `[text](url)` format.\n4. **Humanize numbers** — English: >10K → \"x.xK\" / >1M → \"x.xM\". Chinese: >1万 → \"x.x万\" / >1亿 → \"x.x亿\".\n5. **End with next-step hints** — Contextual suggestions in matching language.\n6. **Data-driven** — All conclusions based on actual API data, never fabricate.\n7. **Honest about gaps** — If data is insufficient, say so and suggest alternatives.\n8. **No credential leakage** — Never output API key values or internal implementation details.\n9. **Region awareness** — Always mention which market (region) the data is from.\n\n## Error Handling\n\n| Error | Response |\n|---|---|\n| 401 Unauthorized | \"API Key is invalid. Please check your key at ecomseer.com.\" |\n| 402 Insufficient Credits | \"Account credits are insufficient. Please top up at ecomseer.com.\" |\n| 403 Forbidden | \"This endpoint is not available for your plan. Visit ecomseer.com for details.\" |\n| 429 Rate Limit | \"Query quota reached. Check your plan at ecomseer.com.\" |\n| Empty results | \"No data found for these criteria. Try: [suggest broader parameters]\" |\n| Partial failure in multi-step | Complete what's possible, note which data is missing and why |\n\nFile v1.0.1:README.md\n\n# EcomSeer — TikTok Shop E-commerce Intelligence Skill\n\n[中文文档](README_CN.md)\n\nAll-in-one TikTok Shop data intelligence assistant. Search products, discover trending items, analyze influencers, explore shops, track video performance, and get ad insights — all through natural language.\n\n## Features\n\n- **Product Search** — Search TikTok Shop products by keyword, category, price, sales volume, with multi-market support\n- **Sales Rankings** — Sales ranking, new products, managed (sShop) ranking, hot promotion ranking\n- **Product Detail** — Deep dive into any product's sales trends, influencer partnerships, video performance, reviews\n- **Influencer Analysis** — Search and analyze TikTok creators: followers, engagement, sales performance, fan demographics\n- **Video Analytics** — Hot video search, video-product ranking, video detail with trend data\n- **Shop Intelligence** — Search shops, view product lineup, analyze influencer partnerships\n- **Ad & Creative Insights** — E-commerce ad search, advertiser analysis, trend insights, top keywords\n- **Deep Research** — AI-powered deep analysis for complex queries. Automatically triggered for multi-dimensional analysis, returns structured HTML reports\n\n## Install\n\n```bash\nnpx clawhub install ecomseer\n```\n\n## Setup\n\n1. Go to [www.ecomseer.com](https://www.ecomseer.com) to register and get your API Key\n2. Configure:\n\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"YOUR_ECOMSEER_API_KEY\"\n```\n\n\n## Usage Examples\n\nAfter setup, just tell your AI assistant:\n\n| Category | Example prompts |\n|----------|----------------|\n| Product Search | \"Search Bluetooth earbuds on TikTok Shop\", \"Find trending skincare products\" |\n| Rankings | \"US TikTok Shop sales ranking\", \"Top new products this week\" |\n| Product Detail | \"Show me this product's sales trend\", \"Which influencers promote this?\" |\n| Influencer | \"Find beauty influencers with 100K+ followers\", \"Analyze this creator's performance\" |\n| Video | \"Hot TikTok Shop videos this week\", \"Show video performance data\" |\n| Shop | \"Search TikTok shops selling electronics\", \"Analyze this shop's product mix\" |\n| Ads | \"Search e-commerce ad creatives\", \"What are the trending ad keywords?\" |\n| Deep Research | \"Analyze US beauty category trends\", \"Compare top 5 shops in Southeast Asia\" |\n\nSupports both **English** and **Chinese** — the assistant responds in your language.\n\n## Multi-Market Support\n\nEcomSeer covers all TikTok Shop markets:\n\n| Region Code | Market |\n|-------------|--------|\n| US | United States |\n| GB | United Kingdom |\n| ID | Indonesia |\n| TH | Thailand |\n| VN | Vietnam |\n| MY | Malaysia |\n| PH | Philippines |\n| SG | Singapore |\n\nDefault market is US. Switch by saying \"show me Indonesia data\" or \"切换到东南亚\".\n\n## Deep Research — AI-Powered Intelligence Reports\n\nFor complex analytical queries, EcomSeer automatically activates its **Deep Research Framework** — a server-side AI research engine that goes far beyond simple API lookups.\n\n**What triggers Deep Research:**\n\n- Category trend analysis: *\"Analyze US beauty category trending products\"*\n- Multi-entity comparisons: *\"Compare these two shops' strategies\"*\n- Market intelligence: *\"Southeast Asia e-commerce opportunity analysis\"*\n- Influencer strategy: *\"Analyze this creator's monetization approach\"*\n- Any question requiring 2+ API calls or cross-entity reasoning\n\n**What you get:**\n\n- Structured HTML report with charts and data tables\n- Executive summary with key findings\n- Cross-dimensional insights (products × influencers × videos × ads)\n- Actionable e-commerce recommendations\n\nThe framework typically completes in 1–5 minutes depending on query complexity. Reports are hosted and shareable via link.\n\n## Links\n\n- Website: [www.ecomseer.com](https://www.ecomseer.com)\n\n---\n\nBuilt by [EcomSeer](https://www.ecomseer.com)\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7c1c01gzrc3m423t8n840m9s81vj6m\",\n  \"slug\": \"ecomseer\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1774344933269\n}\n\nFile v1.0.1:references/api-ad.md\n\n# 广告与创意 (Ad/Creative) + 标签 (Hashtag)\n\nTikTok 广告素材分析模块，覆盖电商广告搜索、种草广告、广告主洞察、趋势分析、热门素材、热词、标签洞察等。标签模块因与广告标签洞察共用上游接口，一并收录。\n\n---\n\n## 广告搜索\n\n### 1. 电商广告搜索\n\n```\nGET /api/open/ads/ec-search\n```\n\n搜索 TikTok 上的电商类广告素材。上游接口：`/api/da/V4/search`。\n\n> **内部固定参数**：`da_type=1`（电商广告）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `order` | str | 否 | - | 排序规则 |\n\n---\n\n### 2. 种草广告搜索\n\n```\nGET /api/open/ads/seed-search\n```\n\n搜索 TikTok 上的种草（内容营销）类广告素材。上游接口：`/api/da/V4/search`。\n\n> **内部固定参数**：`da_type=1`、默认 `scene=3`（种草场景）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `order` | str | 否 | - | 排序规则 |\n| `scene` | int | 否 | 3 | 场景类型（默认 3=种草） |\n\n---\n\n### 3. 广告详情\n\n```\nGET /api/open/ads/detail\n```\n\n获取单条广告素材的详细信息。上游接口：`/api/da/V4/detail`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 广告主\n\n### 4. 广告主洞察\n\n```\nGET /api/open/ads/advertiser\n```\n\n搜索和浏览广告主信息，了解其投放策略。上游接口：`/api/dar/V3/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词（广告主名称） |\n| `order` | str | 否 | - | 排序规则 |\n\n---\n\n### 5. 广告主视频列表\n\n```\nGET /api/open/ads/advertiser/videos\n```\n\n获取指定广告主投放的视频广告列表。上游接口：`/api/dar/V3/videoList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告主 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 6. 广告主商品列表\n\n```\nGET /api/open/ads/advertiser/products\n```\n\n获取指定广告主推广的商品列表。上游接口：`/api/dar/V3/productList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告主 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 趋势与热门\n\n### 7. 趋势洞察\n\n```\nGET /api/open/ads/trend-insights\n```\n\n获取广告投放的趋势洞察数据（按品类维度）。上游接口：`/api/da/V4/trendInsights`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n| `l3_cid` | str | 否 | - | 三级品类 ID，不传则返回整体趋势 |\n\n---\n\n### 8. 热门广告素材\n\n```\nGET /api/open/ads/top-ads\n```\n\n获取当前最热门的广告素材列表。上游接口：`/api/da/V4/topAds`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n| `l3_cid` | str | 否 | - | 三级品类 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n\n---\n\n### 9. 广告热词\n\n```\nGET /api/open/ads/top-keywords\n```\n\n获取当前 TikTok 广告中的热门搜索关键词。上游接口：`/api/da/V4/topKeywords`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 10. 趋势洞察分类筛选\n\n```\nGET /api/open/ads/insights-filter\n```\n\n获取趋势洞察可用的品类筛选选项列表（配合趋势洞察接口使用）。上游接口：`/api/da/V4/insightsFilter`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 标签洞察\n\n### 11. 标签洞察（广告维度）\n\n```\nGET /api/open/ads/tag-search\n```\n\n按标签（hashtag）维度分析广告投放情况。上游接口：`/api/hashtag/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `date_type` | int | 否 | 7 | 时间范围天数 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `cid` | str | 否 | - | 品类 ID |\n| `views` | str | 否 | - | 观看量范围 |\n| `video_num` | str | 否 | - | 关联视频数范围 |\n\n---\n\n### 12. 热门标签搜索\n\n```\nGET /api/open/hashtags/search\n```\n\n搜索 TikTok 上的热门话题标签，查看标签下的观看量、视频数等数据。上游接口：`/api/hashtag/search`。\n\n> **注意**：此接口与上方标签洞察（`/api/open/ads/tag-search`）调用相同上游接口，但路径不同，适用于非广告场景的标签搜索。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `date_type` | int | 否 | 7 | 时间范围天数 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `cid` | str | 否 | - | 品类 ID |\n| `views` | str | 否 | - | 观看量范围 |\n| `video_num` | str | 否 | - | 关联视频数范围 |\n\nFile v1.0.1:references/api-goods.md\n\n# 商品搜索与榜单 (Goods)\n\n商品模块提供 TikTok Shop 商品的多维度搜索和各类排行榜数据。\n\n---\n\n## 1. 商品搜索\n\n```\nGET /api/open/goods/search\n```\n\n根据关键词、品类、价格、销量等多维度条件搜索 TikTok Shop 商品。上游接口：`/api/goods/V2/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `region` | str | 否 | US | 目标市场 |\n| `keyword` | str | 否 | - | 搜索关键词（内部映射为上游 `words` 参数） |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `l1_cid` | str | 否 | - | 一级品类 ID（通过 `/api/open/goods/filters` 获取） |\n| `l2_cid` | str | 否 | - | 二级品类 ID |\n| `l3_cid` | str | 否 | - | 三级品类 ID |\n| `price_min` | str | 否 | - | 最低价格（美元）。与 `price_max` 组合后内部拼接为 `price_amount=min,max` |\n| `price_max` | str | 否 | - | 最高价格（美元），`-1` 表示不限 |\n| `sold_count` | str | 否 | - | 总销量范围，格式 `\"min,max\"` |\n| `day7_sold_count` | str | 否 | - | 近7天销量范围 |\n| `sale_amount` | str | 否 | - | 总销售额范围 |\n| `day7_sale_amount` | str | 否 | - | 近7天销售额范围 |\n| `crate` | str | 否 | - | 佣金率范围 |\n| `relate_author_count` | str | 否 | - | 关联达人数范围 |\n| `author_order_rate` | str | 否 | - | 达人出单率范围 |\n| `is_free_shipping` | str | 否 | - | 是否包邮（\"1\"=是） |\n| `is_new` | str | 否 | - | 是否新品 |\n| `is_hot_sale` | str | 否 | - | 是否热销 |\n| `is_local` | str | 否 | - | 是否本地商品 |\n| `is_cross_border` | str | 否 | - | 是否跨境商品 |\n| `is_sshop` | str | 否 | - | 是否全托管商品（空字符串不传递） |\n| `off_shelves` | str | 否 | - | 是否已下架 |\n| `commerce_type` | str | 否 | - | 电商类型筛选 |\n\n> **注意**：`price_min` 和 `price_max` 不是直接传给上游的，后端会将它们合并为 `price_amount=\"min,max\"` 格式传递。如果只传其中一个，缺失的部分默认为 `0`（min）或 `-1`（max）。\n\n---\n\n## 2. 商品筛选条件\n\n```\nGET /api/open/goods/filters\n```\n\n获取商品搜索可用的筛选条件列表，包括品类树（一级/二级/三级品类 ID 和名称）、价格区间选项等。用于构建搜索筛选 UI 或获取品类 ID。上游接口：`/api/goods/filterInfo`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场，不同市场品类树不同 |\n\n---\n\n## 3. 销量榜\n\n```\nGET /api/open/goods/sale-rank\n```\n\n按销量排名的商品榜单。上游接口：`/api/goods/saleRank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | - | 时间维度类型（如 1=日榜、7=周榜） |\n| `date_value` | str | 否 | - | 具体时间值，与 `date_type` 配合使用 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\n---\n\n## 4. 新品榜\n\n```\nGET /api/open/goods/new-product\n```\n\n新上架商品排行榜。上游接口：`/api/goods/newProduct`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `rank_type` | int | 否 | 11 | 榜单类型，固定为 11 |\n| `dt` | str | 否 | - | 日期筛选 |\n| `cid` | str | 否 | - | 品类 ID |\n| `is_cross_border` | str | 否 | - | 是否跨境商品 |\n| `is_sshop` | str | 否 | - | 是否全托管商品 |\n\n---\n\n## 5. 全托管商品榜\n\n```\nGET /api/open/goods/managed-rank\n```\n\nTikTok Shop 全托管（sShop）模式下的热门商品排行。上游接口：`/api/goods/sShopHotList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"8,2\" | 排序规则（默认按字段8降序） |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\n---\n\n## 6. 热推榜\n\n```\nGET /api/open/goods/hot-rank\n```\n\n被大量达人推广的热门商品排行。上游接口：`/api/goods/popRank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"4,2\" | 排序规则（默认按字段4降序） |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\nFile v1.0.1:references/api-influencer.md\n\n# 达人 (Influencer)\n\nTikTok 达人数据模块，包括多维度达人搜索、各类达人榜单、以及单个达人的全部详情子接口。\n\n---\n\n## 搜索与榜单\n\n### 1. 达人搜索\n\n```\nGET /api/open/influencers/search\n```\n\n多维度搜索 TikTok 达人，支持粉丝数、带货数据、互动率、联系方式等 18+ 筛选条件。上游接口：`/api/author/search`。\n\n> **注意**：值为 `None`、空字符串或 `\"-1\"` 的参数不会传给上游。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"12,2\" | 排序规则（12=综合排序） |\n| `words` | str | 否 | - | 搜索关键词（达人昵称/简介） |\n| `shop_window` | str | 否 | - | 橱窗商品数范围 |\n| `follower` | str | 否 | - | 粉丝数范围，格式 `\"min,max\"` |\n| `cid` | str | 否 | - | 带货品类 ID |\n| `product` | str | 否 | - | 带货商品数范围 |\n| `is_shop` | str | 否 | - | 是否拥有 TikTok Shop 店铺 |\n| `verify` | str | 否 | - | 是否蓝V认证 |\n| `gender` | str | 否 | - | 性别筛选 |\n| `age` | str | 否 | - | 年龄段筛选 |\n| `contact` | str | 否 | - | 是否公开联系方式 |\n| `has_partner` | str | 否 | - | 是否签约 MCN 机构 |\n| `follower_28d_count` | str | 否 | - | 近28天涨粉数范围 |\n| `sale_28d_count` | str | 否 | - | 近28天带货销量范围 |\n| `prod_video_28d_count` | str | 否 | - | 近28天发布带货视频数范围 |\n| `prod_live_28d_count` | str | 否 | - | 近28天开播带货直播数范围 |\n| `avg_28d_play_count` | str | 否 | - | 近28天场均播放量范围 |\n| `avg_28d_sale_play_count` | str | 否 | - | 近28天带货视频场均播放量范围 |\n| `interaction_v1_rate` | str | 否 | - | 互动率范围 |\n| `like_followers_v1_rate` | str | 否 | - | 点赞粉丝比范围 |\n| `first_video_time` | str | 否 | - | 首发视频时间范围 |\n\n---\n\n### 2. 达人榜\n\n```\nGET /api/open/influencers/rank\n```\n\n达人排行榜，支持涨粉榜、蓝V榜、热门榜三种类型。上游接口：`/api/followers/followersList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `type` | int | 否 | 1 | 榜单类型：`1`=涨粉榜、`2`=蓝V榜、`3`=热门榜 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `cid` | str | 否 | - | 品类 ID |\n\n---\n\n### 3. 带货达人榜\n\n```\nGET /api/open/influencers/commerce-rank\n```\n\n按带货销售额/销量排名的达人榜单。上游接口：`/api/ecommerce/rank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | 1 | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `cid` | str | 否 | - | 品类 ID |\n\n---\n\n### 4. 黑马达人榜\n\n```\nGET /api/open/influencers/dark-horse\n```\n\n近期增长迅速的潜力达人排行（黑马榜）。上游接口：`/api/author/potential/rank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `date_type` | int | 否 | 1 | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `is_ecommerce` | int | 否 | 1 | 是否仅带货达人：`1`=是 |\n| `order` | str | 否 | - | 排序规则 |\n| `follower` | str | 否 | - | 粉丝数范围 |\n| `gender` | str | 否 | - | 性别筛选 |\n| `age` | str | 否 | - | 年龄段筛选 |\n| `cid` | str | 否 | - | 品类 ID |\n\n---\n\n## 达人详情\n\n以下接口均需要 `uid`（达人 UID）作为必填参数。\n\n### 5. 达人综合详情\n\n```\nGET /api/open/influencers/detail\n```\n\n获取达人的全面信息。后端内部并行请求 4 个上游接口并合并返回：\n- `/api/author/v3/detail/baseInfo` — 基础资料（昵称、头像、简介、粉丝数等）\n- `/api/author/v3/detail/authorIndex` — 达人指数（带货力、影响力等评分）\n- `/api/author/v3/detail/getStatInfo` — 数据统计（视频数、直播数、商品数等）\n- `/api/author/v3/detail/authorContact` — 联系方式（可能为空）\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n**响应结构**（由后端组装）：\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"base\": { /* 基础资料 */ },\n    \"index\": { /* 达人指数评分 */ },\n    \"stat\": { /* 数据统计 */ },\n    \"contact\": { /* 联系方式，获取失败时为空对象 */ }\n  }\n}\n```\n\n---\n\n### 6. 数据趋势图\n\n```\nGET /api/open/influencers/detail/chart\n```\n\n获取达人某项数据指标在时间范围内的逐日变化趋势。上游接口：`/api/author/v3/detail/dataList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `field_type` | str | 否 | \"follower\" | 数据指标类型，可选：`follower`（粉丝）、`play`（播放）、`digg`（点赞）等 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 7. 粉丝画像\n\n```\nGET /api/open/influencers/detail/fans-portrait\n```\n\n获取达人粉丝的人口统计画像（性别、年龄、地域分布等）。上游接口：`/api/author/v3/detail/fansPortrait`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 8. 达人视频列表\n\n```\nGET /api/open/influencers/detail/videos\n```\n\n获取达人发布的视频列表，可按播放量、点赞数等排序。上游接口：`/api/author/v3/detail/videoList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"play_count,2\" | 排序字段。可选：`play_count`（播放量）、`digg_count`（点赞数）、`create_time`（发布时间），方向 `2`=降序 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 9. 达人商品列表\n\n```\nGET /api/open/influencers/detail/goods\n```\n\n获取达人带货的商品列表。上游接口：`/api/author/v3/detail/goodsList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"sold_count,2\" | 排序字段，`sold_count`=销量降序 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 10. 达人直播列表\n\n```\nGET /api/open/influencers/detail/live\n```\n\n获取达人的直播记录列表。上游接口：`/api/author/v3/detail/liveList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"create_time,2\" | 排序字段，`create_time`=最新优先 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 11. 带货品类分布\n\n```\nGET /api/open/influencers/detail/category-list\n```\n\n获取达人带货商品的品类分布（各品类占比）。上游接口：`/api/author/v3/detail/categoryList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 12. 活跃时段分析\n\n```\nGET /api/open/influencers/detail/active-range\n```\n\n获取达人的发布/活跃时段分布（一周内按小时统计）。上游接口：`/api/author/v3/detail/authorActiveRange`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 13. 相似达人\n\n```\nGET /api/open/influencers/detail/similarity\n```\n\n获取与指定达人风格/品类相似的其他达人列表。上游接口：`/api/author/v3/detail/similarityList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 14. 粉丝活跃分析\n\n```\nGET /api/open/influencers/detail/fans-analysis\n```\n\n获取达人粉丝的活跃度分析数据。上游接口：`/api/author/v3/detail/authorFansAnalysis`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 15. 带货总览\n\n```\nGET /api/open/influencers/detail/cargo-summary\n```\n\n获取达人的带货业绩总览（总销量、总销售额、平均客单价等汇总数据）。上游接口：`/api/author/v3/detail/cargoSummary`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 16. 常用标签\n\n```\nGET /api/open/influencers/detail/labels\n```\n\n获取达人视频中常用的话题标签列表。上游接口：`/api/author/v3/detail/labelList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.1:references/api-product-detail.md\n\n# 商品详情 (Product Detail)\n\n根据商品 ID 获取单个商品的各维度详细数据，包括基础信息、销售趋势、带货视频/达人、评价、直播等。\n\n---\n\n## 1. 商品基础信息\n\n```\nGET /api/open/goods/detail\n```\n\n获取单个商品的基础信息，包括标题、价格、图片、品类、店铺等。上游接口：`/api/goods/v3/base`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 2. 销售趋势概览\n\n```\nGET /api/open/product/overview\n```\n\n获取商品在指定时间范围内的销售趋势数据（销量、销售额、关联达人数等）。上游接口：`/api/goods/v3/overview`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `d_type` | int | 否 | 28 | 时间范围天数，可选 7、28、90 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 3. 带货视频列表\n\n```\nGET /api/open/product/videos\n```\n\n获取推广该商品的视频列表。上游接口：`/api/goods/v3/video`。\n\n> **内部固定参数**：`d_type=0`、`is_promoted=-1`（表示不限推广类型），调用方无需传递。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | 28 | 时间范围（7/28/90天） |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 4. 带货达人列表\n\n```\nGET /api/open/product/authors\n```\n\n获取推广该商品的达人列表。上游接口：`/api/goods/v3/author`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `ecommerce_type` | str | 否 | \"all\" | 电商类型筛选，`all` 表示全部 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 5. 商品评价\n\n```\nGET /api/open/product/reviews\n```\n\n获取商品的用户评价列表。上游接口：`/api/goods/reviewList`。\n\n> **内部固定参数**：`near_day=0`（不限时间）、`is_like=0`（不筛选好评）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 6. 直播带货列表\n\n```\nGET /api/open/product/live\n```\n\n获取通过直播带货推广该商品的直播间列表。上游接口：`/api/goods/v3/live`。\n\n> **内部固定参数**：`live_type=\"all\"`（不筛选直播类型）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `d_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.1:references/api-shop.md\n\n# 店铺 (Shop)\n\nTikTok Shop 店铺数据模块，提供店铺搜索、详情、商品列表、关联达人等。\n\n---\n\n## 1. 店铺筛选条件\n\n```\nGET /api/open/shops/filter-info\n```\n\n获取店铺搜索可用的筛选条件（品类、店铺类型等选项列表）。上游接口：`/api/shop/filterInfo`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 2. 店铺搜索\n\n```\nGET /api/open/shops/search\n```\n\n多条件搜索 TikTok Shop 店铺。上游接口：`/api/shop/V3/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 20 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `words` | str | 否 | - | 搜索关键词（店铺名称） |\n| `cid` | str | 否 | - | 品类 ID |\n| `is_sshop` | str | 否 | - | 是否全托管店铺（空字符串不传递） |\n| `shop_type` | str | 否 | - | 店铺类型 |\n| `shop_position` | str | 否 | - | 店铺所在地 |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `sold_count` | str | 否 | - | 销量范围 |\n| `sale_amount` | str | 否 | - | 销售额范围 |\n| `author_count` | str | 否 | - | 关联达人数范围 |\n| `rating` | str | 否 | - | 店铺评分范围 |\n\n---\n\n## 3. 店铺详情\n\n```\nGET /api/open/shops/detail\n```\n\n获取单个店铺的基础详情信息。上游接口：`/api/shop/V3/base`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 店铺 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 4. 店铺商品列表\n\n```\nGET /api/open/shops/products\n```\n\n获取指定店铺内的商品列表。上游接口：`/api/shop/V3/goods`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 店铺 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 20 | 每页条数，最大 50 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 5. 店铺关联达人\n\n```\nGET /api/open/shops/authors\n```\n\n获取与指定店铺有合作关系的达人列表。上游接口：`/api/shop/V3/author`。\n\n> **注意**：此接口使用 `seller_id` 参数（非 `id`），与其他店铺接口不同。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `seller_id` | str | ✅ | - | 卖家 ID（注意：不是店铺 ID `id`） |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 20 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.1:references/api-video.md\n\n# 视频 (Video)\n\nTikTok 视频数据模块，提供热门视频搜索、视频商品榜、以及单个视频的详情/趋势/带货商品/相似视频等。\n\n---\n\n## 1. 热门视频搜索\n\n```\nGET /api/open/videos/hot\n```\n\n搜索 TikTok 上的热门带货视频，支持按关键词、品类、播放量、互动率等筛选。上游接口：`/api/video/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `d_type` | int | 否 | 7 | 时间范围天数（如 1/3/7/28） |\n| `words` | str | 否 | - | 搜索关键词 |\n| `cid` | str | 否 | - | 品类 ID |\n| `follower` | str | 否 | - | 作者粉丝数范围，格式 `\"min,max\"` |\n| `play` | str | 否 | - | 播放量范围 |\n| `digg` | str | 否 | - | 点赞数范围 |\n| `interact_rate` | str | 否 | - | 互动率范围 |\n| `bind_product` | str | 否 | - | 是否关联商品（空字符串不传递） |\n\n---\n\n## 2. 视频商品榜\n\n```\nGET /api/open/videos/rank\n```\n\n按视频维度聚合的商品排行榜，展示哪些商品通过视频获得最多曝光。上游接口：`/api/video/hotGoodsVideoGroupByProduct`。\n\n> **注意**：上游返回 base64 编码的 JSON，后端自动解码后返回标准 JSON。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `rank_type` | int | 否 | 7 | 时间维度（7=近7天） |\n\n---\n\n## 3. 视频详情\n\n```\nGET /api/open/videos/detail\n```\n\n获取单个视频的详细信息，包括基础概览和数据统计。后端内部并行请求两个上游接口（`/api/video/overview` 和 `/api/video/overviewData`），合并后返回。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n**响应结构**（非标准上游格式，由后端组装）：\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"overview\": { /* 视频基础信息：标题、作者、发布时间、关联商品等 */ },\n    \"stats\": { /* 数据统计：播放量、点赞、评论、分享等 */ }\n  }\n}\n```\n\n---\n\n## 4. 视频数据趋势\n\n```\nGET /api/open/videos/detail/trend\n```\n\n获取视频在指定时间范围内的数据变化趋势（播放量、点赞数等按日变化）。上游接口：`/api/video/V2/base`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `d_type` | int | 否 | 7 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 5. 视频带货商品\n\n```\nGET /api/open/videos/detail/goods\n```\n\n获取某个视频关联推广的商品列表。上游接口：`/api/video/v2/goods`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 6. 相似视频\n\n```\nGET /api/open/videos/detail/similar\n```\n\n获取与指定视频内容相似的视频列表。上游接口：`/api/video/similar`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.1:README_CN.md\n\n# EcomSeer — TikTok Shop 跨境电商数据 Skill\n\n[English](README.md)\n\n一站式 TikTok Shop 数据情报助手。通过自然语言搜索商品、发现爆品、分析达人、探索店铺、追踪视频表现、获取广告洞察。\n\n## 功能\n\n- **商品搜索** — 按关键词、品类、价格、销量等多维度搜索 TikTok Shop 商品，支持多市场\n- **销量榜单** — 销量榜、新品榜、全托管商品榜、热推榜\n- **商品详情** — 深入分析商品销售趋势、达人合作、视频带货表现、用户评价\n- **达人分析** — 搜索和分析 TikTok 带货达人：粉丝、互动率、带货业绩、粉丝画像\n- **视频分析** — 热门视频搜索、视频商品排行、视频详情与趋势数据\n- **店铺分析** — 搜索店铺、查看商品阵容、分析达人合作情况\n- **广告洞察** — 电商广告搜索、广告主分析、趋势洞察、热门关键词\n- **深度研究** — AI 驱动的深度分析，适用于复杂查询。自动触发多维度分析，返回结构化 HTML 报告\n\n## 安装\n\n```bash\nnpx clawhub install ecomseer\n```\n\n## 配置\n\n1. 前往 [www.ecomseer.com](https://www.ecomseer.com) 注册并获取 API Key\n2. 配置环境变量：\n\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"你的ECOMSEER_API_KEY\"\n```\n\n## 使用示例\n\n安装配置完成后，直接对 AI 助手说：\n\n| 分类 | 示例指令 |\n|------|----------|\n| 商品搜索 | 「搜一下蓝牙耳机」「找美妆个护爆品」 |\n| 榜单 | 「美国销量榜 Top10」「这周新品排行」 |\n| 商品详情 | 「这个商品销量趋势怎么样」「有哪些达人在带这个货」 |\n| 达人 | 「找10万粉以上的美妆达人」「分析一下这个达人的带货情况」 |\n| 视频 | 「本周热门带货视频」「看看这个视频的数据」 |\n| 店铺 | 「搜一下卖电子产品的店铺」「分析这个店铺的商品结构」 |\n| 广告 | 「搜电商广告素材」「最近热门的广告关键词有哪些」 |\n| 深度研究 | 「分析美国美妆品类趋势」「对比东南亚 Top5 店铺」 |\n\n支持 **中文** 和 **英文** 双语 — 助手会自动匹配你的语言。\n\n## 多市场支持\n\nEcomSeer 覆盖 TikTok Shop 全部市场：\n\n| 市场代码 | 市场 |\n|----------|------|\n| US | 美国 |\n| GB | 英国 |\n| ID | 印度尼西亚 |\n| TH | 泰国 |\n| VN | 越南 |\n| MY | 马来西亚 |\n| PH | 菲律宾 |\n| SG | 新加坡 |\n\n默认市场为美国。说「切换到东南亚」或 \"show me Indonesia data\" 即可切换。\n\n## 深度研究 — AI 驱动的智能分析报告\n\n面对复杂的分析需求，EcomSeer 会自动激活 **深度研究引擎** — 一个服务端 AI 研究系统，远超简单的 API 查询。\n\n**什么情况会触发深度研究：**\n\n- 品类趋势分析：*「分析美国美妆品类的爆品趋势」*\n- 多实体对比：*「对比这两个店铺的运营策略」*\n- 市场情报：*「东南亚电商市场机会分析」*\n- 达人策略：*「分析这个达人的变现模式」*\n- 任何需要 2 个以上 API 调用或跨实体推理的问题\n\n**你会得到：**\n\n- 带图表和数据表格的结构化 HTML 报告\n- 核心发现的摘要\n- 跨维度洞察（商品 × 达人 × 视频 × 广告）\n- 可执行的电商运营建议\n\n研究引擎通常在 1-5 分钟内完成，取决于查询复杂度。报告在线托管，支持链接分享。\n\n## 链接\n\n- 官网：[www.ecomseer.com](https://www.ecomseer.com)\n\n---\n\n由 [EcomSeer](https://www.ecomseer.com) 提供技术支持\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nEcomSeer helps agents search TikTok Shop products, rankings, influencers, shops, videos, ads, and deeper EcomSeer research reports through natural-language requests.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[fly0pants](https://clawhub.ai/user/fly0pants)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal e-commerce operators, sellers, and analysts use this skill through an agent to query TikTok Shop market data, compare products, shops, influencers, videos, and ads, and request deeper EcomSeer research reports.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can store pasted EcomSeer API keys for later API use.\n\nMitigation: Use a dedicated, revocable EcomSeer API key with the least access available and avoid pasting secrets into chat where possible.\n\nRisk: Deep Research can send the user's query, context, and API key to EcomSeer server-side infrastructure and create a shareable hosted report link.\n\nMitigation: Use Deep Research only for data acceptable to send to EcomSeer infrastructure, and review hosted report links before sharing them.\n\nRisk: The release documentation uses an unpinned npx install command.\n\nMitigation: Review the installer source and release version before installing or deploying the skill.\n\n## Reference(s):\n\n- [EcomSeer Website](https://www.ecomseer.com)\n- [ClawHub Skill Page](https://clawhub.ai/fly0pants/skills/ecomseer)\n- [Goods API Reference](references/api-goods.md)\n- [Product Detail API Reference](references/api-product-detail.md)\n- [Influencer API Reference](references/api-influencer.md)\n- [Video API Reference](references/api-video.md)\n- [Shop API Reference](references/api-shop.md)\n- [Ad and Creative API Reference](references/api-ad.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown responses with tables, summaries, shell commands, and links to hosted HTML reports for deeper research.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Responses mirror the user's language; complex research may use EcomSeer server-side analysis and return a shareable hosted report link.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release metadata)\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.0: 10 files, 21850 bytes\n\nFiles: README_CN.md (3552b), README.md (3866b), references/api-ad.md (6504b), references/api-goods.md (5293b), references/api-influencer.md (10761b), references/api-product-detail.md (3446b), references/api-shop.md (2903b), references/api-video.md (3776b), SKILL.md (17824b), _meta.json (127b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: ecomseer\ndescription: \"TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights via ecomseer.com. Triggers: 找商品, 搜商品, 爆品, 带货, TikTok电商, 达人分析, 视频带货, 店铺分析, 广告素材, 销量榜, 跨境电商, search products, find trending, TikTok Shop, influencer analysis, shop data, ad creatives, sales ranking, e-commerce analytics, product research.\"\nmetadata: {\"openclaw\":{\"emoji\":\"🛒\",\"primaryEnv\":\"ECOMSEER_API_KEY\"}}\n---\n\n# EcomSeer — TikTok Shop Intelligence Assistant\n\nYou are a TikTok Shop e-commerce data analyst assistant. Help users search products, discover trending items, analyze influencers, explore shops, track video performance, and understand ad strategies — all via the EcomSeer API.\n\n## Language Handling / 语言适配\n\nDetect the user's language from their **first message** and maintain it throughout the conversation.\n\n| User language | Response language | Number format | Example output |\n|---|---|---|---|\n| 中文 | 中文 | 万/亿 (e.g. 1.2亿) | \"共找到 5,000 条商品\" |\n| English | English | K/M/B (e.g. 120M) | \"Found 5,000 products\" |\n\n**Rules:**\n1. **All text output** (summaries, analysis, table headers, insights, follow-up hints) must match the detected language.\n2. **Field name presentation:**\n   - Chinese → use Chinese labels: 商品名称, 销量, 销售额, 达人数, 评分\n   - English → use English labels: Product Name, Sales, Revenue, Influencers, Rating\n3. **Error messages** must also match: \"未找到数据\" vs \"No data found\".\n4. If the user **switches language mid-conversation**, follow the new language from that point on.\n\n## API Access\n\nBase URL: `https://www.ecomseer.com`\nAuth header: `X-API-Key: $ECOMSEER_API_KEY`\n\nAll endpoints are GET requests:\n\n```bash\ncurl -s \"https://www.ecomseer.com/api/open/{endpoint}?{params}\" \\\n  -H \"X-API-Key: $ECOMSEER_API_KEY\"\n```\n\n**Key conventions:**\n- All endpoints start with `/api/open/`\n- `region` param defaults to `US`. Other markets: GB, ID, TH, VN, MY, PH, SG, etc.\n- Range filters use `\"min,max\"` format, `-1` means no limit (e.g. `sold_count=100,-1` means sales ≥ 100)\n- Sort param `order` format: `\"field_number,direction\"`, 2=desc (e.g. `order=2,2`)\n- Pagination: `page` (starts at 1), `pagesize` (default 10-20, max 50)\n\n## Interaction Flow\n\n### Step 1: Check API Key\n\nBefore any query, run: `[ -n \"$ECOMSEER_API_KEY\" ] && echo \"ok\" || echo \"missing\"`\n\n**Never print the key value.**\n\n#### If missing — show setup guide\n\n**Reply with EXACTLY this (Chinese user):**\n\n> 🔑 需要先配置 EcomSeer API Key 才能使用：\n>\n> 1. 打开 https://www.ecomseer.com 注册账号\n> 2. 登录后在控制台找到 API Keys，创建一个 Key\n> 3. 拿到 Key 后回来找我，我帮你配置 ✅\n\n**Reply with EXACTLY this (English user):**\n\n> 🔑 You need an EcomSeer API Key to get started:\n>\n> 1. Go to https://www.ecomseer.com and sign up\n> 2. After signing in, find API Keys in your dashboard and create one\n> 3. Come back with your key and I'll set it up for you ✅\n\nThen STOP. Wait for the user to return with their key.\n\n**❌ DO NOT** just say \"please provide your API key\" without the registration link.\n\n#### Auto-detect: if the user pastes an API key directly in chat (e.g. `fmk_xxxxx`)\n\n1. Run this command (replace `{KEY}` with the actual key):\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"{KEY}\"\n```\n2. Reply: `✅ API Key 已配置成功！` (or English equivalent), then immediately proceed with the user's original query.\n\n**❌ DO NOT** echo/print the key value back.\n\n### Step 1.5: Complexity Classification — 复杂度分类\n\nBefore routing, classify the query complexity to decide the execution path:\n\n| Complexity | Criteria | Path | Examples |\n|---|---|---|---|\n| **Simple** | Can be answered with exactly 1 API call; single-entity, single-metric lookup | Skill handles directly (Step 2 onward) | \"US销量榜\", \"搜一下蓝牙耳机\", \"这个达人的粉丝数\", \"Top 10 新品\" |\n| **Deep** | Requires 2+ API calls, any cross-entity/cross-dimensional query, analysis, comparison, or trend interpretation | Route to Deep Research Framework | \"分析美妆品类爆品趋势\", \"对比这两个店铺\", \"达人带货策略分析\", \"东南亚市场机会分析\" |\n\n**Classification rule — count the API calls needed:**\n\nSimple (exactly 1 API call):\n- Single search: \"搜一下蓝牙耳机\" → 1× goods/search\n- Single ranking: \"US销量榜Top10\" → 1× goods/sale-rank\n- Single detail: \"这个商品的评分\" → 1× goods/detail\n- Filter options: \"有哪些品类\" → 1× goods/filters\n\nDeep (2+ API calls):\n- Any query requiring entity lookup + data fetch: \"XX达人带了什么货\" needs search→detail = 2 calls → **Deep**\n- Any analysis: \"分析XX\" → always multi-call → **Deep**\n- Any comparison: \"对比XX和YY\" → always multi-call → **Deep**\n- Any market overview: \"XX品类市场分析\" → always multi-call → **Deep**\n- Any trend: \"XX趋势\" → always multi-call → **Deep**\n\n**Default:** If unsure, classify as **Deep** (prefer thorough over incomplete).\n\n**Execution paths:**\n\n**→ Simple path:** Continue to Step 2 (existing routing logic). At the end of the response, append a hint in the user's language:\n- Chinese: `💡 需要更深入的分析？试试说\"深度分析{topic}\"`\n- English: `💡 Want deeper analysis? Try \"deep research on {topic}\"`\n\n**→ Deep path:** Call the Deep Research Framework.\n\nThis is a 4-step process. Do NOT use `[[reply_to_current]]` until the final step.\n\n**Step 0 — Validate API key before submitting:**\n\nRun this command first to verify the API key is valid:\n```bash\ncurl -s -o /dev/null -w \"%{http_code}\" \"https://www.ecomseer.com/api/open/goods/filters?region=US\" -H \"X-API-Key: $ECOMSEER_API_KEY\"\n```\n\n- If it returns `200` → key is valid, proceed to Step 1.\n- If it returns `401` or `403` → key is invalid. Show this message and STOP:\n  - Chinese: `❌ API Key 无效，请检查你的 Key 是否正确。前往 https://www.ecomseer.com 重新获取。`\n  - English: `❌ API Key is invalid. Please check your key at https://www.ecomseer.com`\n- Do NOT submit to deep research if validation fails.\n\n**Step 1 — Submit the research task (returns instantly):**\n\nRun this exact command (only replace `{user_query}` and `{additional_context}`):\n```bash\ncurl -s -X POST \"https://deepresearch.admapix.com/research\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer test-local-token-2026\" \\\n  -d '{\"project\": \"ecomseer\", \"query\": \"{user_query}\", \"context\": \"{additional_context}\", \"api_key\": \"'\"$ECOMSEER_API_KEY\"'\"}'\n```\n\n- `project` is always `\"ecomseer\"` — do NOT change this.\n- `query` is the user's research question (in the user's language).\n- `context` is optional — add useful context if relevant. Omit or set to `null` if not needed.\n- `api_key` passes the user's API key to the framework — always include it as shown above.\n\nThis returns immediately with:\n```json\n{\"task_id\": \"dr_xxxx-xxxx-xxxx\", \"status\": \"pending\", \"created_at\": \"...\"}\n```\n\nExtract the `task_id` value for Step 2.\n\n**Step 2 — Poll until done (use this exact script, do NOT modify):**\n\nRun this exact command, only replacing `{task_id}`:\n```bash\nwhile true; do r=$(curl -s \"https://deepresearch.admapix.com/research/{task_id}\" -H \"Authorization: Bearer test-local-token-2026\"); s=$(echo \"$r\" | grep -o '\"status\":\"[^\"]*\"' | head -1 | cut -d'\"' -f4); echo \"status=$s\"; if [ \"$s\" = \"completed\" ] || [ \"$s\" = \"failed\" ]; then echo \"$r\"; break; fi; sleep 15; done\n```\n\nThis script polls every 15 seconds and exits only when the task is done. It may take 1-5 minutes. **Do NOT interrupt it, do NOT add a loop limit, do NOT abandon it.**\n\n**Step 3 — Format and reply to the user with the framework's report.**\n\n**CRITICAL RULES:**\n- Do NOT send `[[reply_to_current]]` before Step 2 completes — it will stop execution.\n- **NEVER fall back to manual analysis.** The framework WILL complete — just wait for it.\n- **NEVER write your own polling loop.** Use the exact script above.\n\n**Processing the response JSON:**\n\nThe completed response has this structure:\n```json\n{\n  \"task_id\": \"dr_xxxx\",\n  \"status\": \"completed\",\n  \"output\": {\n    \"format\": \"html\",\n    \"files\": [{\"name\": \"report.html\", \"url\": \"https://pub-a760a2c961554a558faba40a40ac9e08.r2.dev/deep-research/{task_id}/report.html\", ...}],\n    \"summary\": \"- 核心发现1\\n- 核心发现2\\n- ...\"\n  },\n  \"usage\": {\"model\": \"gpt-5.4\", \"total_tokens\": 286599, \"research_time_seconds\": 187.7}\n}\n```\n\nDo NOT paste the full report into the chat. Instead:\n\n1. Take `output.summary` (already formatted as bullet points) and present it directly as the key findings\n2. Append the report link from `output.files[0].url`: `[📊 查看完整报告]({url})`\n3. Add follow-up hints based on the summary content\n\n**If the task failed** (status=`\"failed\"`):\n- The response will contain `\"error\": {\"message\": \"...\"}` with a user-friendly reason\n- Present the error to the user and suggest they try again or simplify their query\n- Do NOT try to manually replicate the analysis\n\n**Example output (Chinese):**\n```\n📊 深度分析完成！\n\n**核心发现：**\n- 美国美妆个护TOP10爆品以化妆刷具和面部护肤为主\n- Tarte化妆刷近28天销量6.53万，客单价$39，显著高于均值\n- 视频带货贡献明显：28天关联视频212条、带货达人185人\n- 运营建议：优先布局\"高视觉效果+强使用演示+中高客单\"品类\n\n👉 [查看完整报告](https://pub-a760a2c961554a558faba40a40ac9e08.r2.dev/deep-research/dr_xxxx/report.html)\n\n💡 试试：\"看看达人榜\" | \"搜一下蓝牙耳机\" | \"东南亚市场对比\"\n```\n\n**If Step 1 returns an error with `\"code\": \"api_key_required\"`:** The user's API key is missing or not configured. Output the same API key setup instructions from the \"Check API Key\" section above and stop.\n\n**If the framework is unreachable (connection refused/timeout on Step 1):** Fall back to the existing routing logic (Step 2 → route by intent).\n\n---\n\n### Step 2: Route — Classify Intent & Load Reference\n\nRead the user's request and classify into one of these intent groups. Then **read only the reference file(s) needed** before executing.\n\n| Intent Group | Trigger signals | Reference file to read | Key endpoints |\n|---|---|---|---|\n| **Product Search** | 搜商品, 找商品, 搜一下, 爆品, search products, find items | `references/api-goods.md` | goods/search, goods/filters |\n| **Rankings** | 榜单, Top, 销量榜, 新品榜, 热推榜, ranking, top products | `references/api-goods.md` | goods/sale-rank, goods/new-product, goods/hot-rank, goods/managed-rank |\n| **Product Detail** | 商品详情, 这个商品, 销量趋势, 带货视频, product detail | `references/api-product-detail.md` | goods/detail, product/overview, product/videos, product/authors |\n| **Influencer** | 达人, KOL, 带货达人, 搜达人, influencer, creator | `references/api-influencer.md` | influencers/search, influencers/rank, influencers/detail |\n| **Video** | 视频, 热门视频, 视频分析, hot videos, video analysis | `references/api-video.md` | videos/hot, videos/rank, videos/detail |\n| **Shop** | 店铺, 店铺分析, 搜店铺, shop, store | `references/api-shop.md` | shops/search, shops/detail, shops/products |\n| **Ad & Creative** | 广告, 素材, 投放, 广告主, ads, creatives, advertiser | `references/api-ad.md` | ads/ec-search, ads/advertiser, ads/trend-insights, ads/top-ads |\n| **Deep Dive** | 全面分析, 深度分析, 市场分析, 对比, full analysis, strategy | Multiple files as needed | Multi-endpoint orchestration |\n\n**Rules:**\n- If uncertain, default to **Product Search** (most common use case).\n- For **Deep Dive**, read reference files incrementally as each step requires them.\n- Always check region context — default is US unless the user specifies otherwise.\n\n### Step 3: Classify Action Mode\n\n| Mode | Signal | Behavior |\n|---|---|---|\n| **Browse** | \"搜\", \"找\", \"看看\", \"search\", \"find\", \"show me\" | Single query, return formatted list + summary |\n| **Analyze** | \"分析\", \"top\", \"趋势\", \"why\", \"哪个最火\" | Query + structured analysis |\n| **Compare** | \"对比\", \"vs\", \"区别\", \"compare\" | Multiple queries, side-by-side comparison |\n\n**Default for Product Search / Rankings: Browse.**\n\n### Step 4: Plan & Execute\n\n**Single-group queries:** Follow the reference file's request format and execute.\n\n**Cross-group orchestration (Deep Dive):** Chain multiple endpoints. Common patterns:\n\n#### Pattern A: \"分析 {品类} 的爆品趋势\" — Category Trend Analysis\n\n1. `GET /api/open/goods/filters` → get category IDs\n2. `GET /api/open/goods/sale-rank?l1_cid={cid}&region=US` → top sellers\n3. `GET /api/open/goods/detail?product_id={id}` → detail for each top product\n4. `GET /api/open/product/overview?product_id={id}` → sales trends\n5. `GET /api/open/product/authors?product_id={id}` → influencer data\n\n#### Pattern B: \"对比 {达人A} 和 {达人B}\" — Influencer Comparison\n\n1. `GET /api/open/influencers/search?words={name}` → find each influencer\n2. `GET /api/open/influencers/detail?uid={uid}` → profile for each\n3. `GET /api/open/influencers/detail/goods?uid={uid}` → product portfolio for each\n4. `GET /api/open/influencers/detail/cargo-summary?uid={uid}` → sales summary for each\n\n#### Pattern C: \"{市场} 机会分析\" — Market Opportunity\n\n1. `GET /api/open/goods/sale-rank?region={region}` → top sellers in market\n2. `GET /api/open/goods/new-product?region={region}` → new entrants\n3. `GET /api/open/influencers/commerce-rank?region={region}` → top commerce influencers\n4. `GET /api/open/shops/search?region={region}` → top shops\n\n#### Pattern D: \"{店铺} 经营分析\" — Shop Performance\n\n1. `GET /api/open/shops/search?words={name}` → find shop\n2. `GET /api/open/shops/detail?id={id}` → shop info\n3. `GET /api/open/shops/products?id={id}` → product lineup\n4. `GET /api/open/shops/authors?seller_id={seller_id}` → influencer partnerships\n\n**Execution rules:**\n- Execute all planned queries autonomously — do not ask for confirmation on each sub-query.\n- Run independent queries in parallel when possible (multiple curl calls in one code block).\n- If a step fails with 401/403, check API key validity — do not abort the entire analysis.\n- If a step returns empty data, say so honestly and suggest parameter adjustments.\n\n### Step 5: Output Results\n\n#### Browse Mode\n\n**Chinese template:**\n```\n🛒 共找到 {total} 条\"{keyword}\"相关商品\n\n| # | 商品 | 价格 | 近7天销量 | 销售额 | 达人数 |\n|---|------|------|-----------|--------|--------|\n| 1 | {title} | ${price} | {sold} | ${amount} | {authors} |\n| ... |\n\n💡 试试：\"分析Top3\" | \"看看达人\" | \"切换到东南亚\"\n```\n\n**English template:**\n```\n🛒 Found {total} products for \"{keyword}\"\n\n| # | Product | Price | 7d Sales | Revenue | Influencers |\n|---|---------|-------|----------|---------|-------------|\n| 1 | {title} | ${price} | {sold} | ${amount} | {authors} |\n| ... |\n\n💡 Try: \"analyze top 3\" | \"show influencers\" | \"switch to Southeast Asia\"\n```\n\n#### Analyze Mode\n\nAdapt output format to the question. Use tables for rankings, bullet points for insights. Always end with **Key findings** section.\n\n#### Compare Mode\n\nSide-by-side table + differential insights.\n\n#### Deep Dive Mode\n\nStructured report with sections. Adapt language to user.\n\n### Step 6: Follow-up Handling\n\nMaintain full context. Handle follow-ups intelligently:\n\n| Follow-up | Action |\n|---|---|\n| \"next page\" / \"下一页\" | Same params, page +1 |\n| \"analyze\" / \"分析一下\" | Switch to analyze mode on current data |\n| \"compare with X\" / \"和X对比\" | Add X as second query, compare mode |\n| \"show influencers\" / \"看看达人\" | Route to influencers/search for current category |\n| \"video data\" / \"视频数据\" | Route to videos/hot or product/videos |\n| \"which shops\" / \"哪些店铺\" | Route to shops/search |\n| \"ad insights\" / \"广告分析\" | Route to ads/ec-search |\n| Adjust filters | Modify params, re-execute |\n| Change region | Update region param, re-execute |\n\n**Reuse data:** If the user asks follow-up questions about already-fetched data, analyze existing results first. Only make new API calls when needed.\n\n## Output Guidelines\n\n1. **Language consistency** — ALL output must match the user's detected language.\n2. **Route-appropriate output** — Don't dump tables for browsing; don't skip data for analysis.\n3. **Markdown links** — All URLs in `[text](url)` format.\n4. **Humanize numbers** — English: >10K → \"x.xK\" / >1M → \"x.xM\". Chinese: >1万 → \"x.x万\" / >1亿 → \"x.x亿\".\n5. **End with next-step hints** — Contextual suggestions in matching language.\n6. **Data-driven** — All conclusions based on actual API data, never fabricate.\n7. **Honest about gaps** — If data is insufficient, say so and suggest alternatives.\n8. **No credential leakage** — Never output API key values or internal implementation details.\n9. **Region awareness** — Always mention which market (region) the data is from.\n\n## Error Handling\n\n| Error | Response |\n|---|---|\n| 401 Unauthorized | \"API Key is invalid. Please check your key at ecomseer.com.\" |\n| 402 Insufficient Credits | \"Account credits are insufficient. Please top up at ecomseer.com.\" |\n| 403 Forbidden | \"This endpoint is not available for your plan. Visit ecomseer.com for details.\" |\n| 429 Rate Limit | \"Query quota reached. Check your plan at ecomseer.com.\" |\n| Empty results | \"No data found for these criteria. Try: [suggest broader parameters]\" |\n| Partial failure in multi-step | Complete what's possible, note which data is missing and why |\n\nFile v1.0.0:README.md\n\n# EcomSeer — TikTok Shop E-commerce Intelligence Skill\n\n[中文文档](README_CN.md)\n\nAll-in-one TikTok Shop data intelligence assistant. Search products, discover trending items, analyze influencers, explore shops, track video performance, and get ad insights — all through natural language.\n\n## Features\n\n- **Product Search** — Search TikTok Shop products by keyword, category, price, sales volume, with multi-market support\n- **Sales Rankings** — Sales ranking, new products, managed (sShop) ranking, hot promotion ranking\n- **Product Detail** — Deep dive into any product's sales trends, influencer partnerships, video performance, reviews\n- **Influencer Analysis** — Search and analyze TikTok creators: followers, engagement, sales performance, fan demographics\n- **Video Analytics** — Hot video search, video-product ranking, video detail with trend data\n- **Shop Intelligence** — Search shops, view product lineup, analyze influencer partnerships\n- **Ad & Creative Insights** — E-commerce ad search, advertiser analysis, trend insights, top keywords\n- **Deep Research** — AI-powered deep analysis for complex queries. Automatically triggered for multi-dimensional analysis, returns structured HTML reports\n\n## Install\n\n```bash\nnpx clawhub install ecomseer\n```\n\n## Setup\n\n1. Go to [www.ecomseer.com](https://www.ecomseer.com) to register and get your API Key\n2. Configure:\n\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"YOUR_ECOMSEER_API_KEY\"\n```\n\n## Usage Examples\n\nAfter setup, just tell your AI assistant:\n\n| Category | Example prompts |\n|----------|----------------|\n| Product Search | \"Search Bluetooth earbuds on TikTok Shop\", \"Find trending skincare products\" |\n| Rankings | \"US TikTok Shop sales ranking\", \"Top new products this week\" |\n| Product Detail | \"Show me this product's sales trend\", \"Which influencers promote this?\" |\n| Influencer | \"Find beauty influencers with 100K+ followers\", \"Analyze this creator's performance\" |\n| Video | \"Hot TikTok Shop videos this week\", \"Show video performance data\" |\n| Shop | \"Search TikTok shops selling electronics\", \"Analyze this shop's product mix\" |\n| Ads | \"Search e-commerce ad creatives\", \"What are the trending ad keywords?\" |\n| Deep Research | \"Analyze US beauty category trends\", \"Compare top 5 shops in Southeast Asia\" |\n\nSupports both **English** and **Chinese** — the assistant responds in your language.\n\n## Multi-Market Support\n\nEcomSeer covers all TikTok Shop markets:\n\n| Region Code | Market |\n|-------------|--------|\n| US | United States |\n| GB | United Kingdom |\n| ID | Indonesia |\n| TH | Thailand |\n| VN | Vietnam |\n| MY | Malaysia |\n| PH | Philippines |\n| SG | Singapore |\n\nDefault market is US. Switch by saying \"show me Indonesia data\" or \"切换到东南亚\".\n\n## Deep Research — AI-Powered Intelligence Reports\n\nFor complex analytical queries, EcomSeer automatically activates its **Deep Research Framework** — a server-side AI research engine that goes far beyond simple API lookups.\n\n**What triggers Deep Research:**\n\n- Category trend analysis: *\"Analyze US beauty category trending products\"*\n- Multi-entity comparisons: *\"Compare these two shops' strategies\"*\n- Market intelligence: *\"Southeast Asia e-commerce opportunity analysis\"*\n- Influencer strategy: *\"Analyze this creator's monetization approach\"*\n- Any question requiring 2+ API calls or cross-entity reasoning\n\n**What you get:**\n\n- Structured HTML report with charts and data tables\n- Executive summary with key findings\n- Cross-dimensional insights (products × influencers × videos × ads)\n- Actionable e-commerce recommendations\n\nThe framework typically completes in 1–5 minutes depending on query complexity. Reports are hosted and shareable via link.\n\n## Links\n\n- Website: [www.ecomseer.com](https://www.ecomseer.com)\n\n---\n\nBuilt by [EcomSeer](https://www.ecomseer.com)\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7c1c01gzrc3m423t8n840m9s81vj6m\",\n  \"slug\": \"ecomseer\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1774342391342\n}\n\nFile v1.0.0:references/api-ad.md\n\n# 广告与创意 (Ad/Creative) + 标签 (Hashtag)\n\nTikTok 广告素材分析模块，覆盖电商广告搜索、种草广告、广告主洞察、趋势分析、热门素材、热词、标签洞察等。标签模块因与广告标签洞察共用上游接口，一并收录。\n\n---\n\n## 广告搜索\n\n### 1. 电商广告搜索\n\n```\nGET /api/open/ads/ec-search\n```\n\n搜索 TikTok 上的电商类广告素材。上游接口：`/api/da/V4/search`。\n\n> **内部固定参数**：`da_type=1`（电商广告）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `order` | str | 否 | - | 排序规则 |\n\n---\n\n### 2. 种草广告搜索\n\n```\nGET /api/open/ads/seed-search\n```\n\n搜索 TikTok 上的种草（内容营销）类广告素材。上游接口：`/api/da/V4/search`。\n\n> **内部固定参数**：`da_type=1`、默认 `scene=3`（种草场景）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `order` | str | 否 | - | 排序规则 |\n| `scene` | int | 否 | 3 | 场景类型（默认 3=种草） |\n\n---\n\n### 3. 广告详情\n\n```\nGET /api/open/ads/detail\n```\n\n获取单条广告素材的详细信息。上游接口：`/api/da/V4/detail`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 广告主\n\n### 4. 广告主洞察\n\n```\nGET /api/open/ads/advertiser\n```\n\n搜索和浏览广告主信息，了解其投放策略。上游接口：`/api/dar/V3/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词（广告主名称） |\n| `order` | str | 否 | - | 排序规则 |\n\n---\n\n### 5. 广告主视频列表\n\n```\nGET /api/open/ads/advertiser/videos\n```\n\n获取指定广告主投放的视频广告列表。上游接口：`/api/dar/V3/videoList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告主 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 6. 广告主商品列表\n\n```\nGET /api/open/ads/advertiser/products\n```\n\n获取指定广告主推广的商品列表。上游接口：`/api/dar/V3/productList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告主 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 趋势与热门\n\n### 7. 趋势洞察\n\n```\nGET /api/open/ads/trend-insights\n```\n\n获取广告投放的趋势洞察数据（按品类维度）。上游接口：`/api/da/V4/trendInsights`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n| `l3_cid` | str | 否 | - | 三级品类 ID，不传则返回整体趋势 |\n\n---\n\n### 8. 热门广告素材\n\n```\nGET /api/open/ads/top-ads\n```\n\n获取当前最热门的广告素材列表。上游接口：`/api/da/V4/topAds`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n| `l3_cid` | str | 否 | - | 三级品类 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n\n---\n\n### 9. 广告热词\n\n```\nGET /api/open/ads/top-keywords\n```\n\n获取当前 TikTok 广告中的热门搜索关键词。上游接口：`/api/da/V4/topKeywords`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 10. 趋势洞察分类筛选\n\n```\nGET /api/open/ads/insights-filter\n```\n\n获取趋势洞察可用的品类筛选选项列表（配合趋势洞察接口使用）。上游接口：`/api/da/V4/insightsFilter`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 标签洞察\n\n### 11. 标签洞察（广告维度）\n\n```\nGET /api/open/ads/tag-search\n```\n\n按标签（hashtag）维度分析广告投放情况。上游接口：`/api/hashtag/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `date_type` | int | 否 | 7 | 时间范围天数 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `cid` | str | 否 | - | 品类 ID |\n| `views` | str | 否 | - | 观看量范围 |\n| `video_num` | str | 否 | - | 关联视频数范围 |\n\n---\n\n### 12. 热门标签搜索\n\n```\nGET /api/open/hashtags/search\n```\n\n搜索 TikTok 上的热门话题标签，查看标签下的观看量、视频数等数据。上游接口：`/api/hashtag/search`。\n\n> **注意**：此接口与上方标签洞察（`/api/open/ads/tag-search`）调用相同上游接口，但路径不同，适用于非广告场景的标签搜索。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `date_type` | int | 否 | 7 | 时间范围天数 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `cid` | str | 否 | - | 品类 ID |\n| `views` | str | 否 | - | 观看量范围 |\n| `video_num` | str | 否 | - | 关联视频数范围 |\n\nFile v1.0.0:references/api-goods.md\n\n# 商品搜索与榜单 (Goods)\n\n商品模块提供 TikTok Shop 商品的多维度搜索和各类排行榜数据。\n\n---\n\n## 1. 商品搜索\n\n```\nGET /api/open/goods/search\n```\n\n根据关键词、品类、价格、销量等多维度条件搜索 TikTok Shop 商品。上游接口：`/api/goods/V2/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `region` | str | 否 | US | 目标市场 |\n| `keyword` | str | 否 | - | 搜索关键词（内部映射为上游 `words` 参数） |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `l1_cid` | str | 否 | - | 一级品类 ID（通过 `/api/open/goods/filters` 获取） |\n| `l2_cid` | str | 否 | - | 二级品类 ID |\n| `l3_cid` | str | 否 | - | 三级品类 ID |\n| `price_min` | str | 否 | - | 最低价格（美元）。与 `price_max` 组合后内部拼接为 `price_amount=min,max` |\n| `price_max` | str | 否 | - | 最高价格（美元），`-1` 表示不限 |\n| `sold_count` | str | 否 | - | 总销量范围，格式 `\"min,max\"` |\n| `day7_sold_count` | str | 否 | - | 近7天销量范围 |\n| `sale_amount` | str | 否 | - | 总销售额范围 |\n| `day7_sale_amount` | str | 否 | - | 近7天销售额范围 |\n| `crate` | str | 否 | - | 佣金率范围 |\n| `relate_author_count` | str | 否 | - | 关联达人数范围 |\n| `author_order_rate` | str | 否 | - | 达人出单率范围 |\n| `is_free_shipping` | str | 否 | - | 是否包邮（\"1\"=是） |\n| `is_new` | str | 否 | - | 是否新品 |\n| `is_hot_sale` | str | 否 | - | 是否热销 |\n| `is_local` | str | 否 | - | 是否本地商品 |\n| `is_cross_border` | str | 否 | - | 是否跨境商品 |\n| `is_sshop` | str | 否 | - | 是否全托管商品（空字符串不传递） |\n| `off_shelves` | str | 否 | - | 是否已下架 |\n| `commerce_type` | str | 否 | - | 电商类型筛选 |\n\n> **注意**：`price_min` 和 `price_max` 不是直接传给上游的，后端会将它们合并为 `price_amount=\"min,max\"` 格式传递。如果只传其中一个，缺失的部分默认为 `0`（min）或 `-1`（max）。\n\n---\n\n## 2. 商品筛选条件\n\n```\nGET /api/open/goods/filters\n```\n\n获取商品搜索可用的筛选条件列表，包括品类树（一级/二级/三级品类 ID 和名称）、价格区间选项等。用于构建搜索筛选 UI 或获取品类 ID。上游接口：`/api/goods/filterInfo`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场，不同市场品类树不同 |\n\n---\n\n## 3. 销量榜\n\n```\nGET /api/open/goods/sale-rank\n```\n\n按销量排名的商品榜单。上游接口：`/api/goods/saleRank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | - | 时间维度类型（如 1=日榜、7=周榜） |\n| `date_value` | str | 否 | - | 具体时间值，与 `date_type` 配合使用 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\n---\n\n## 4. 新品榜\n\n```\nGET /api/open/goods/new-product\n```\n\n新上架商品排行榜。上游接口：`/api/goods/newProduct`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `rank_type` | int | 否 | 11 | 榜单类型，固定为 11 |\n| `dt` | str | 否 | - | 日期筛选 |\n| `cid` | str | 否 | - | 品类 ID |\n| `is_cross_border` | str | 否 | - | 是否跨境商品 |\n| `is_sshop` | str | 否 | - | 是否全托管商品 |\n\n---\n\n## 5. 全托管商品榜\n\n```\nGET /api/open/goods/managed-rank\n```\n\nTikTok Shop 全托管（sShop）模式下的热门商品排行。上游接口：`/api/goods/sShopHotList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"8,2\" | 排序规则（默认按字段8降序） |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\n---\n\n## 6. 热推榜\n\n```\nGET /api/open/goods/hot-rank\n```\n\n被大量达人推广的热门商品排行。上游接口：`/api/goods/popRank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"4,2\" | 排序规则（默认按字段4降序） |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\nFile v1.0.0:references/api-influencer.md\n\n# 达人 (Influencer)\n\nTikTok 达人数据模块，包括多维度达人搜索、各类达人榜单、以及单个达人的全部详情子接口。\n\n---\n\n## 搜索与榜单\n\n### 1. 达人搜索\n\n```\nGET /api/open/influencers/search\n```\n\n多维度搜索 TikTok 达人，支持粉丝数、带货数据、互动率、联系方式等 18+ 筛选条件。上游接口：`/api/author/search`。\n\n> **注意**：值为 `None`、空字符串或 `\"-1\"` 的参数不会传给上游。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"12,2\" | 排序规则（12=综合排序） |\n| `words` | str | 否 | - | 搜索关键词（达人昵称/简介） |\n| `shop_window` | str | 否 | - | 橱窗商品数范围 |\n| `follower` | str | 否 | - | 粉丝数范围，格式 `\"min,max\"` |\n| `cid` | str | 否 | - | 带货品类 ID |\n| `product` | str | 否 | - | 带货商品数范围 |\n| `is_shop` | str | 否 | - | 是否拥有 TikTok Shop 店铺 |\n| `verify` | str | 否 | - | 是否蓝V认证 |\n| `gender` | str | 否 | - | 性别筛选 |\n| `age` | str | 否 | - | 年龄段筛选 |\n| `contact` | str | 否 | - | 是否公开联系方式 |\n| `has_partner` | str | 否 | - | 是否签约 MCN 机构 |\n| `follower_28d_count` | str | 否 | - | 近28天涨粉数范围 |\n| `sale_28d_count` | str | 否 | - | 近28天带货销量范围 |\n| `prod_video_28d_count` | str | 否 | - | 近28天发布带货视频数范围 |\n| `prod_live_28d_count` | str | 否 | - | 近28天开播带货直播数范围 |\n| `avg_28d_play_count` | str | 否 | - | 近28天场均播放量范围 |\n| `avg_28d_sale_play_count` | str | 否 | - | 近28天带货视频场均播放量范围 |\n| `interaction_v1_rate` | str | 否 | - | 互动率范围 |\n| `like_followers_v1_rate` | str | 否 | - | 点赞粉丝比范围 |\n| `first_video_time` | str | 否 | - | 首发视频时间范围 |\n\n---\n\n### 2. 达人榜\n\n```\nGET /api/open/influencers/rank\n```\n\n达人排行榜，支持涨粉榜、蓝V榜、热门榜三种类型。上游接口：`/api/followers/followersList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `type` | int | 否 | 1 | 榜单类型：`1`=涨粉榜、`2`=蓝V榜、`3`=热门榜 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `cid` | str | 否 | - | 品类 ID |\n\n---\n\n### 3. 带货达人榜\n\n```\nGET /api/open/influencers/commerce-rank\n```\n\n按带货销售额/销量排名的达人榜单。上游接口：`/api/ecommerce/rank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | 1 | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `cid` | str | 否 | - | 品类 ID |\n\n---\n\n### 4. 黑马达人榜\n\n```\nGET /api/open/influencers/dark-horse\n```\n\n近期增长迅速的潜力达人排行（黑马榜）。上游接口：`/api/author/potential/rank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `date_type` | int | 否 | 1 | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `is_ecommerce` | int | 否 | 1 | 是否仅带货达人：`1`=是 |\n| `order` | str | 否 | - | 排序规则 |\n| `follower` | str | 否 | - | 粉丝数范围 |\n| `gender` | str | 否 | - | 性别筛选 |\n| `age` | str | 否 | - | 年龄段筛选 |\n| `cid` | str | 否 | - | 品类 ID |\n\n---\n\n## 达人详情\n\n以下接口均需要 `uid`（达人 UID）作为必填参数。\n\n### 5. 达人综合详情\n\n```\nGET /api/open/influencers/detail\n```\n\n获取达人的全面信息。后端内部并行请求 4 个上游接口并合并返回：\n- `/api/author/v3/detail/baseInfo` — 基础资料（昵称、头像、简介、粉丝数等）\n- `/api/author/v3/detail/authorIndex` — 达人指数（带货力、影响力等评分）\n- `/api/author/v3/detail/getStatInfo` — 数据统计（视频数、直播数、商品数等）\n- `/api/author/v3/detail/authorContact` — 联系方式（可能为空）\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n**响应结构**（由后端组装）：\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"base\": { /* 基础资料 */ },\n    \"index\": { /* 达人指数评分 */ },\n    \"stat\": { /* 数据统计 */ },\n    \"contact\": { /* 联系方式，获取失败时为空对象 */ }\n  }\n}\n```\n\n---\n\n### 6. 数据趋势图\n\n```\nGET /api/open/influencers/detail/chart\n```\n\n获取达人某项数据指标在时间范围内的逐日变化趋势。上游接口：`/api/author/v3/detail/dataList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `field_type` | str | 否 | \"follower\" | 数据指标类型，可选：`follower`（粉丝）、`play`（播放）、`digg`（点赞）等 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 7. 粉丝画像\n\n```\nGET /api/open/influencers/detail/fans-portrait\n```\n\n获取达人粉丝的人口统计画像（性别、年龄、地域分布等）。上游接口：`/api/author/v3/detail/fansPortrait`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 8. 达人视频列表\n\n```\nGET /api/open/influencers/detail/videos\n```\n\n获取达人发布的视频列表，可按播放量、点赞数等排序。上游接口：`/api/author/v3/detail/videoList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"play_count,2\" | 排序字段。可选：`play_count`（播放量）、`digg_count`（点赞数）、`create_time`（发布时间），方向 `2`=降序 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 9. 达人商品列表\n\n```\nGET /api/open/influencers/detail/goods\n```\n\n获取达人带货的商品列表。上游接口：`/api/author/v3/detail/goodsList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"sold_count,2\" | 排序字段，`sold_count`=销量降序 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 10. 达人直播列表\n\n```\nGET /api/open/influencers/detail/live\n```\n\n获取达人的直播记录列表。上游接口：`/api/author/v3/detail/liveList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"create_time,2\" | 排序字段，`create_time`=最新优先 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 11. 带货品类分布\n\n```\nGET /api/open/influencers/detail/category-list\n```\n\n获取达人带货商品的品类分布（各品类占比）。上游接口：`/api/author/v3/detail/categoryList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 12. 活跃时段分析\n\n```\nGET /api/open/influencers/detail/active-range\n```\n\n获取达人的发布/活跃时段分布（一周内按小时统计）。上游接口：`/api/author/v3/detail/authorActiveRange`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `date_type` | int | 否 | 28 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 13. 相似达人\n\n```\nGET /api/open/influencers/detail/similarity\n```\n\n获取与指定达人风格/品类相似的其他达人列表。上游接口：`/api/author/v3/detail/similarityList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 14. 粉丝活跃分析\n\n```\nGET /api/open/influencers/detail/fans-analysis\n```\n\n获取达人粉丝的活跃度分析数据。上游接口：`/api/author/v3/detail/authorFansAnalysis`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 15. 带货总览\n\n```\nGET /api/open/influencers/detail/cargo-summary\n```\n\n获取达人的带货业绩总览（总销量、总销售额、平均客单价等汇总数据）。上游接口：`/api/author/v3/detail/cargoSummary`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 16. 常用标签\n\n```\nGET /api/open/influencers/detail/labels\n```\n\n获取达人视频中常用的话题标签列表。上游接口：`/api/author/v3/detail/labelList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `uid` | str | ✅ | - | 达人 UID |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.0:references/api-product-detail.md\n\n# 商品详情 (Product Detail)\n\n根据商品 ID 获取单个商品的各维度详细数据，包括基础信息、销售趋势、带货视频/达人、评价、直播等。\n\n---\n\n## 1. 商品基础信息\n\n```\nGET /api/open/goods/detail\n```\n\n获取单个商品的基础信息，包括标题、价格、图片、品类、店铺等。上游接口：`/api/goods/v3/base`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 2. 销售趋势概览\n\n```\nGET /api/open/product/overview\n```\n\n获取商品在指定时间范围内的销售趋势数据（销量、销售额、关联达人数等）。上游接口：`/api/goods/v3/overview`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `d_type` | int | 否 | 28 | 时间范围天数，可选 7、28、90 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 3. 带货视频列表\n\n```\nGET /api/open/product/videos\n```\n\n获取推广该商品的视频列表。上游接口：`/api/goods/v3/video`。\n\n> **内部固定参数**：`d_type=0`、`is_promoted=-1`（表示不限推广类型），调用方无需传递。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | 28 | 时间范围（7/28/90天） |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 4. 带货达人列表\n\n```\nGET /api/open/product/authors\n```\n\n获取推广该商品的达人列表。上游接口：`/api/goods/v3/author`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `ecommerce_type` | str | 否 | \"all\" | 电商类型筛选，`all` 表示全部 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 5. 商品评价\n\n```\nGET /api/open/product/reviews\n```\n\n获取商品的用户评价列表。上游接口：`/api/goods/reviewList`。\n\n> **内部固定参数**：`near_day=0`（不限时间）、`is_like=0`（不筛选好评）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 6. 直播带货列表\n\n```\nGET /api/open/product/live\n```\n\n获取通过直播带货推广该商品的直播间列表。上游接口：`/api/goods/v3/live`。\n\n> **内部固定参数**：`live_type=\"all\"`（不筛选直播类型）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `product_id` | str | ✅ | - | 商品 ID |\n| `page` | int | 否 | 1 | 页码 |\n| `pagesize` | int | 否 | 5 | 每页条数，最大 10 |\n| `d_type` | int | 否 | 28 | 时间范围天数 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.0:references/api-shop.md\n\n# 店铺 (Shop)\n\nTikTok Shop 店铺数据模块，提供店铺搜索、详情、商品列表、关联达人等。\n\n---\n\n## 1. 店铺筛选条件\n\n```\nGET /api/open/shops/filter-info\n```\n\n获取店铺搜索可用的筛选条件（品类、店铺类型等选项列表）。上游接口：`/api/shop/filterInfo`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 2. 店铺搜索\n\n```\nGET /api/open/shops/search\n```\n\n多条件搜索 TikTok Shop 店铺。上游接口：`/api/shop/V3/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 20 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `words` | str | 否 | - | 搜索关键词（店铺名称） |\n| `cid` | str | 否 | - | 品类 ID |\n| `is_sshop` | str | 否 | - | 是否全托管店铺（空字符串不传递） |\n| `shop_type` | str | 否 | - | 店铺类型 |\n| `shop_position` | str | 否 | - | 店铺所在地 |\n| `date_type` | int | 否 | - | 时间维度类型 |\n| `date_value` | str | 否 | - | 具体时间值 |\n| `sold_count` | str | 否 | - | 销量范围 |\n| `sale_amount` | str | 否 | - | 销售额范围 |\n| `author_count` | str | 否 | - | 关联达人数范围 |\n| `rating` | str | 否 | - | 店铺评分范围 |\n\n---\n\n## 3. 店铺详情\n\n```\nGET /api/open/shops/detail\n```\n\n获取单个店铺的基础详情信息。上游接口：`/api/shop/V3/base`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 店铺 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 4. 店铺商品列表\n\n```\nGET /api/open/shops/products\n```\n\n获取指定店铺内的商品列表。上游接口：`/api/shop/V3/goods`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 店铺 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 20 | 每页条数，最大 50 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 5. 店铺关联达人\n\n```\nGET /api/open/shops/authors\n```\n\n获取与指定店铺有合作关系的达人列表。上游接口：`/api/shop/V3/author`。\n\n> **注意**：此接口使用 `seller_id` 参数（非 `id`），与其他店铺接口不同。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `seller_id` | str | ✅ | - | 卖家 ID（注意：不是店铺 ID `id`） |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 20 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.0:references/api-video.md\n\n# 视频 (Video)\n\nTikTok 视频数据模块，提供热门视频搜索、视频商品榜、以及单个视频的详情/趋势/带货商品/相似视频等。\n\n---\n\n## 1. 热门视频搜索\n\n```\nGET /api/open/videos/hot\n```\n\n搜索 TikTok 上的热门带货视频，支持按关键词、品类、播放量、互动率等筛选。上游接口：`/api/video/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `d_type` | int | 否 | 7 | 时间范围天数（如 1/3/7/28） |\n| `words` | str | 否 | - | 搜索关键词 |\n| `cid` | str | 否 | - | 品类 ID |\n| `follower` | str | 否 | - | 作者粉丝数范围，格式 `\"min,max\"` |\n| `play` | str | 否 | - | 播放量范围 |\n| `digg` | str | 否 | - | 点赞数范围 |\n| `interact_rate` | str | 否 | - | 互动率范围 |\n| `bind_product` | str | 否 | - | 是否关联商品（空字符串不传递） |\n\n---\n\n## 2. 视频商品榜\n\n```\nGET /api/open/videos/rank\n```\n\n按视频维度聚合的商品排行榜，展示哪些商品通过视频获得最多曝光。上游接口：`/api/video/hotGoodsVideoGroupByProduct`。\n\n> **注意**：上游返回 base64 编码的 JSON，后端自动解码后返回标准 JSON。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `rank_type` | int | 否 | 7 | 时间维度（7=近7天） |\n\n---\n\n## 3. 视频详情\n\n```\nGET /api/open/videos/detail\n```\n\n获取单个视频的详细信息，包括基础概览和数据统计。后端内部并行请求两个上游接口（`/api/video/overview` 和 `/api/video/overviewData`），合并后返回。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n**响应结构**（非标准上游格式，由后端组装）：\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"overview\": { /* 视频基础信息：标题、作者、发布时间、关联商品等 */ },\n    \"stats\": { /* 数据统计：播放量、点赞、评论、分享等 */ }\n  }\n}\n```\n\n---\n\n## 4. 视频数据趋势\n\n```\nGET /api/open/videos/detail/trend\n```\n\n获取视频在指定时间范围内的数据变化趋势（播放量、点赞数等按日变化）。上游接口：`/api/video/V2/base`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `d_type` | int | 否 | 7 | 时间范围天数 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 5. 视频带货商品\n\n```\nGET /api/open/videos/detail/goods\n```\n\n获取某个视频关联推广的商品列表。上游接口：`/api/video/v2/goods`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 6. 相似视频\n\n```\nGET /api/open/videos/detail/similar\n```\n\n获取与指定视频内容相似的视频列表。上游接口：`/api/video/similar`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 视频 ID |\n| `region` | str | 否 | US | 目标市场 |\n\nFile v1.0.0:README_CN.md\n\n# EcomSeer — TikTok Shop 跨境电商数据 Skill\n\n[English](README.md)\n\n一站式 TikTok Shop 数据情报助手。通过自然语言搜索商品、发现爆品、分析达人、探索店铺、追踪视频表现、获取广告洞察。\n\n## 功能\n\n- **商品搜索** — 按关键词、品类、价格、销量等多维度搜索 TikTok Shop 商品，支持多市场\n- **销量榜单** — 销量榜、新品榜、全托管商品榜、热推榜\n- **商品详情** — 深入分析商品销售趋势、达人合作、视频带货表现、用户评价\n- **达人分析** — 搜索和分析 TikTok 带货达人：粉丝、互动率、带货业绩、粉丝画像\n- **视频分析** — 热门视频搜索、视频商品排行、视频详情与趋势数据\n- **店铺分析** — 搜索店铺、查看商品阵容、分析达人合作情况\n- **广告洞察** — 电商广告搜索、广告主分析、趋势洞察、热门关键词\n- **深度研究** — AI 驱动的深度分析，适用于复杂查询。自动触发多维度分析，返回结构化 HTML 报告\n\n## 安装\n\n```bash\nnpx clawhub install ecomseer\n```\n\n## 配置\n\n1. 前往 [www.ecomseer.com](https://www.ecomseer.com) 注册并获取 API Key\n2. 配置环境变量：\n\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"你的ECOMSEER_API_KEY\"\n```\n\n## 使用示例\n\n安装配置完成后，直接对 AI 助手说：\n\n| 分类 | 示例指令 |\n|------|----------|\n| 商品搜索 | 「搜一下蓝牙耳机」「找美妆个护爆品」 |\n| 榜单 | 「美国销量榜 Top10」「这周新品排行」 |\n| 商品详情 | 「这个商品销量趋势怎么样」「有哪些达人在带这个货」 |\n| 达人 | 「找10万粉以上的美妆达人」「分析一下这个达人的带货情况」 |\n| 视频 | 「本周热门带货视频」「看看这个视频的数据」 |\n| 店铺 | 「搜一下卖电子产品的店铺」「分析这个店铺的商品结构」 |\n| 广告 | 「搜电商广告素材」「最近热门的广告关键词有哪些」 |\n| 深度研究 | 「分析美国美妆品类趋势」「对比东南亚 Top5 店铺」 |\n\n支持 **中文** 和 **英文** 双语 — 助手会自动匹配你的语言。\n\n## 多市场支持\n\nEcomSeer 覆盖 TikTok Shop 全部市场：\n\n| 市场代码 | 市场 |\n|----------|------|\n| US | 美国 |\n| GB | 英国 |\n| ID | 印度尼西亚 |\n| TH | 泰国 |\n| VN | 越南 |\n| MY | 马来西亚 |\n| PH | 菲律宾 |\n| SG | 新加坡 |\n\n默认市场为美国。说「切换到东南亚」或 \"show me Indonesia data\" 即可切换。\n\n## 深度研究 — AI 驱动的智能分析报告\n\n面对复杂的分析需求，EcomSeer 会自动激活 **深度研究引擎** — 一个服务端 AI 研究系统，远超简单的 API 查询。\n\n**什么情况会触发深度研究：**\n\n- 品类趋势分析：*「分析美国美妆品类的爆品趋势」*\n- 多实体对比：*「对比这两个店铺的运营策略」*\n- 市场情报：*「东南亚电商市场机会分析」*\n- 达人策略：*「分析这个达人的变现模式」*\n- 任何需要 2 个以上 API 调用或跨实体推理的问题\n\n**你会得到：**\n\n- 带图表和数据表格的结构化 HTML 报告\n- 核心发现的摘要\n- 跨维度洞察（商品 × 达人 × 视频 × 广告）\n- 可执行的电商运营建议\n\n研究引擎通常在 1-5 分钟内完成，取决于查询复杂度。报告在线托管，支持链接分享。\n\n## 链接\n\n- 官网：[www.ecomseer.com](https://www.ecomseer.com)\n\n---\n\n由 [EcomSeer](https://www.ecomseer.com) 提供技术支持","readmeExcerpt":"Skill: EcomSeer Owner: fly0pants Summary: TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-03-24T09:35:33.269Z | user Version 1.0.1 - Switched the Deep Research endpoint from deepresearch.admapix.com to deepresearch.ecomseer.com for all research task submiss","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"curl -s \"https://www.ecomseer.com/api/open/{endpoint}?{params}\" \\\n  -H \"X-API-Key: $ECOMSEER_API_KEY\""},{"language":"bash","snippet":"curl -s \"https://www.ecomseer.com/api/open/{endpoint}?{params}\" \\\n  -H \"X-API-Key: $ECOMSEER_API_KEY\""},{"language":"bash","snippet":"openclaw config set skills.entries.ecomseer.apiKey \"{KEY}\""},{"language":"bash","snippet":"curl -s -o /dev/null -w \"%{http_code}\" \"https://www.ecomseer.com/api/open/goods/filters?region=US\" -H \"X-API-Key: $ECOMSEER_API_KEY\""},{"language":"bash","snippet":"curl -s -o /dev/null -w \"%{http_code}\" \"https://www.ecomseer.com/api/open/goods/filters?region=US\" -H \"X-API-Key: $ECOMSEER_API_KEY\""},{"language":"bash","snippet":"curl -s -X POST \"https://deepresearch.ecomseer.com/research\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer test-local-token-2026\" \\\n  -d '{\"project\": \"ecomseer\", \"query\": \"{user_query}\", \"context\": \"{additional_context}\", \"api_key\": \"'\"$ECOMSEER_API_KEY\"'\"}'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: ecomseer\ndescription: \"TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights via ecomseer.com. Triggers: 找商品, 搜商品, 爆品, 带货, TikTok电商, 达人分析, 视频带货, 店铺分析, 广告素材, 销量榜, 跨境电商, search products, find trending, TikTok Shop, influencer analysis, shop data, ad creatives, sales ranking, e-commerce analytics, product research.\"\nmetadata: {\"openclaw\":{\"emoji\":\"🛒\",\"primaryEnv\":\"ECOMSEER_API_KEY\"}}\n---\n\n# EcomSeer — TikTok Shop Intelligence Assistant\n\nYou are a TikTok Shop e-commerce data analyst assistant. Help users search products, discover trending items, analyze influencers, explore shops, track video performance, and understand ad strategies — all via the EcomSeer API.\n\n## Language Handling / 语言适配\n\nDetect the user's language from their **first message** and maintain it throughout the conversation.\n\n| User language | Response language | Number format | Example output |\n|---|---|---|---|\n| 中文 | 中文 | 万/亿 (e.g. 1.2亿) | \"共找到 5,000 条商品\" |\n| English | English | K/M/B (e.g. 120M) | \"Found 5,000 products\" |\n\n**Rules:**\n1. **All text output** (summaries, analysis, table headers, insights, follow-up hints) must match the detected language.\n2. **Field name presentation:**\n   - Chinese → use Chinese labels: 商品名称, 销量, 销售额, 达人数, 评分\n   - English → use English labels: Product Name, Sales, Revenue, Influencers, Rating\n3. **Error messages** must also match: \"未找到数据\" vs \"No data found\".\n4. If the user **switches language mid-conversation**, follow the new language from that point on.\n\n## API Access\n\nBase URL: `https://www.ecomseer.com`\nAuth header: `X-API-Key: $ECOMSEER_API_KEY`\n\nAll endpoints are GET requests:\n\n```bash\ncurl -s \"https://www.ecomseer.com/api/open/{endpoint}?{params}\" \\\n  -H \"X-API-Key: $ECOMSEER_API_KEY\"\n```\n\n**Key conventions:**\n- All endpoints start with `/api/open/`\n- `region` param defaults to `US`. Other markets: GB, ID, TH, VN, MY, PH, SG, etc.\n- Range filters use `\"min,max\"` format, `-1` means no limit (e.g. `sold_count=100,-1` means sales ≥ 100)\n- Sort param `order` format: `\"field_number,direction\"`, 2=desc (e.g. `order=2,2`)\n- Pagination: `page` (starts at 1), `pagesize` (default 10-20, max 50)\n\n## Interaction Flow\n\n### Step 1: Check API Key\n\nBefore any query, run: `[ -n \"$ECOMSEER_API_KEY\" ] && echo \"ok\" || echo \"missing\"`\n\n**Never print the key value.**\n\n#### If missing — show setup guide\n\n**Reply with EXACTLY this (Chinese user):**\n\n> 🔑 需要先配置 EcomSeer API Key 才能使用：\n>\n> 1. 打开 https://www.ecomseer.com 注册账号\n> 2. 登录后在控制台找到 API Keys，创建一个 Key\n> 3. 拿到 Key 后回来找我，我帮你配置 ✅\n\n**Reply with EXACTLY this (English user):**\n\n> 🔑 You need an EcomSeer API Key to get started:\n>\n> 1. Go to https://www.ecomseer.com and sign up\n> 2. After signing in, find API Keys in your dashboard and create one\n> 3. Come back with your key and I'll set it up for you ✅\n\nThen STOP. Wait for the user to return with their key.\n\n**❌ DO NOT** just say \"please provide your API key"},{"path":"README.md","content":"# EcomSeer — TikTok Shop E-commerce Intelligence Skill\n\n[中文文档](README_CN.md)\n\nAll-in-one TikTok Shop data intelligence assistant. Search products, discover trending items, analyze influencers, explore shops, track video performance, and get ad insights — all through natural language.\n\n## Features\n\n- **Product Search** — Search TikTok Shop products by keyword, category, price, sales volume, with multi-market support\n- **Sales Rankings** — Sales ranking, new products, managed (sShop) ranking, hot promotion ranking\n- **Product Detail** — Deep dive into any product's sales trends, influencer partnerships, video performance, reviews\n- **Influencer Analysis** — Search and analyze TikTok creators: followers, engagement, sales performance, fan demographics\n- **Video Analytics** — Hot video search, video-product ranking, video detail with trend data\n- **Shop Intelligence** — Search shops, view product lineup, analyze influencer partnerships\n- **Ad & Creative Insights** — E-commerce ad search, advertiser analysis, trend insights, top keywords\n- **Deep Research** — AI-powered deep analysis for complex queries. Automatically triggered for multi-dimensional analysis, returns structured HTML reports\n\n## Install\n\n```bash\nnpx clawhub install ecomseer\n```\n\n## Setup\n\n1. Go to [www.ecomseer.com](https://www.ecomseer.com) to register and get your API Key\n2. Configure:\n\n```bash\nopenclaw config set skills.entries.ecomseer.apiKey \"YOUR_ECOMSEER_API_KEY\"\n```\n\n\n## Usage Examples\n\nAfter setup, just tell your AI assistant:\n\n| Category | Example prompts |\n|----------|----------------|\n| Product Search | \"Search Bluetooth earbuds on TikTok Shop\", \"Find trending skincare products\" |\n| Rankings | \"US TikTok Shop sales ranking\", \"Top new products this week\" |\n| Product Detail | \"Show me this product's sales trend\", \"Which influencers promote this?\" |\n| Influencer | \"Find beauty influencers with 100K+ followers\", \"Analyze this creator's performance\" |\n| Video | \"Hot TikTok Shop videos this week\", \"Show video performance data\" |\n| Shop | \"Search TikTok shops selling electronics\", \"Analyze this shop's product mix\" |\n| Ads | \"Search e-commerce ad creatives\", \"What are the trending ad keywords?\" |\n| Deep Research | \"Analyze US beauty category trends\", \"Compare top 5 shops in Southeast Asia\" |\n\nSupports both **English** and **Chinese** — the assistant responds in your language.\n\n## Multi-Market Support\n\nEcomSeer covers all TikTok Shop markets:\n\n| Region Code | Market |\n|-------------|--------|\n| US | United States |\n| GB | United Kingdom |\n| ID | Indonesia |\n| TH | Thailand |\n| VN | Vietnam |\n| MY | Malaysia |\n| PH | Philippines |\n| SG | Singapore |\n\nDefault market is US. Switch by saying \"show me Indonesia data\" or \"切换到东南亚\".\n\n## Deep Research — AI-Powered Intelligence Reports\n\nFor complex analytical queries, EcomSeer automatically activates its **Deep Research Framework** — a server-side AI research engine that goes far beyond simple API lookups.\n\n**What triggers Deep Research:**\n\n-"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7c1c01gzrc3m423t8n840m9s81vj6m\",\n  \"slug\": \"ecomseer\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1774344933269\n}"},{"path":"references/api-ad.md","content":"# 广告与创意 (Ad/Creative) + 标签 (Hashtag)\n\nTikTok 广告素材分析模块，覆盖电商广告搜索、种草广告、广告主洞察、趋势分析、热门素材、热词、标签洞察等。标签模块因与广告标签洞察共用上游接口，一并收录。\n\n---\n\n## 广告搜索\n\n### 1. 电商广告搜索\n\n```\nGET /api/open/ads/ec-search\n```\n\n搜索 TikTok 上的电商类广告素材。上游接口：`/api/da/V4/search`。\n\n> **内部固定参数**：`da_type=1`（电商广告）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `order` | str | 否 | - | 排序规则 |\n\n---\n\n### 2. 种草广告搜索\n\n```\nGET /api/open/ads/seed-search\n```\n\n搜索 TikTok 上的种草（内容营销）类广告素材。上游接口：`/api/da/V4/search`。\n\n> **内部固定参数**：`da_type=1`、默认 `scene=3`（种草场景）。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词 |\n| `order` | str | 否 | - | 排序规则 |\n| `scene` | int | 否 | 3 | 场景类型（默认 3=种草） |\n\n---\n\n### 3. 广告详情\n\n```\nGET /api/open/ads/detail\n```\n\n获取单条广告素材的详细信息。上游接口：`/api/da/V4/detail`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告 ID |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 广告主\n\n### 4. 广告主洞察\n\n```\nGET /api/open/ads/advertiser\n```\n\n搜索和浏览广告主信息，了解其投放策略。上游接口：`/api/dar/V3/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n| `words` | str | 否 | - | 搜索关键词（广告主名称） |\n| `order` | str | 否 | - | 排序规则 |\n\n---\n\n### 5. 广告主视频列表\n\n```\nGET /api/open/ads/advertiser/videos\n```\n\n获取指定广告主投放的视频广告列表。上游接口：`/api/dar/V3/videoList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告主 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n### 6. 广告主商品列表\n\n```\nGET /api/open/ads/advertiser/products\n```\n\n获取指定广告主推广的商品列表。上游接口：`/api/dar/V3/productList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `id` | str | ✅ | - | 广告主 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n| `region` | str | 否 | US | 目标市场 |\n\n---\n\n## 趋势与热门\n\n### 7. 趋势洞察\n\n```\nGET /api/open/ads/trend-insights\n```\n\n获取广告投放的趋势洞察数据（按品类维度）。上游接口：`/api/da/V4/trendInsights`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n| `l3_cid` | str | 否 | - | 三级品类 ID，不传则返回整体趋势 |\n\n---\n\n### 8. 热门广告素材\n\n```\nGET /api/open/ads/top-ads\n```\n\n获取当前最热门的广告素材列表。上游接口：`/api/da/V4/topAds`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场 |\n| `l3_cid` | str | 否 | - | 三级品类 ID |\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |\n\n---\n\n### 9. 广告热词\n\n```\nGET /api/open/ads/top-keywords\n```\n\n获取当前 TikTok 广告中的热门搜索关键词。上游接口：`/api/da/V4/topKeywords`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 |"},{"path":"references/api-goods.md","content":"# 商品搜索与榜单 (Goods)\n\n商品模块提供 TikTok Shop 商品的多维度搜索和各类排行榜数据。\n\n---\n\n## 1. 商品搜索\n\n```\nGET /api/open/goods/search\n```\n\n根据关键词、品类、价格、销量等多维度条件搜索 TikTok Shop 商品。上游接口：`/api/goods/V2/search`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |\n| `region` | str | 否 | US | 目标市场 |\n| `keyword` | str | 否 | - | 搜索关键词（内部映射为上游 `words` 参数） |\n| `order` | str | 否 | \"2,2\" | 排序规则 |\n| `l1_cid` | str | 否 | - | 一级品类 ID（通过 `/api/open/goods/filters` 获取） |\n| `l2_cid` | str | 否 | - | 二级品类 ID |\n| `l3_cid` | str | 否 | - | 三级品类 ID |\n| `price_min` | str | 否 | - | 最低价格（美元）。与 `price_max` 组合后内部拼接为 `price_amount=min,max` |\n| `price_max` | str | 否 | - | 最高价格（美元），`-1` 表示不限 |\n| `sold_count` | str | 否 | - | 总销量范围，格式 `\"min,max\"` |\n| `day7_sold_count` | str | 否 | - | 近7天销量范围 |\n| `sale_amount` | str | 否 | - | 总销售额范围 |\n| `day7_sale_amount` | str | 否 | - | 近7天销售额范围 |\n| `crate` | str | 否 | - | 佣金率范围 |\n| `relate_author_count` | str | 否 | - | 关联达人数范围 |\n| `author_order_rate` | str | 否 | - | 达人出单率范围 |\n| `is_free_shipping` | str | 否 | - | 是否包邮（\"1\"=是） |\n| `is_new` | str | 否 | - | 是否新品 |\n| `is_hot_sale` | str | 否 | - | 是否热销 |\n| `is_local` | str | 否 | - | 是否本地商品 |\n| `is_cross_border` | str | 否 | - | 是否跨境商品 |\n| `is_sshop` | str | 否 | - | 是否全托管商品（空字符串不传递） |\n| `off_shelves` | str | 否 | - | 是否已下架 |\n| `commerce_type` | str | 否 | - | 电商类型筛选 |\n\n> **注意**：`price_min` 和 `price_max` 不是直接传给上游的，后端会将它们合并为 `price_amount=\"min,max\"` 格式传递。如果只传其中一个，缺失的部分默认为 `0`（min）或 `-1`（max）。\n\n---\n\n## 2. 商品筛选条件\n\n```\nGET /api/open/goods/filters\n```\n\n获取商品搜索可用的筛选条件列表，包括品类树（一级/二级/三级品类 ID 和名称）、价格区间选项等。用于构建搜索筛选 UI 或获取品类 ID。上游接口：`/api/goods/filterInfo`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `region` | str | 否 | US | 目标市场，不同市场品类树不同 |\n\n---\n\n## 3. 销量榜\n\n```\nGET /api/open/goods/sale-rank\n```\n\n按销量排名的商品榜单。上游接口：`/api/goods/saleRank`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `date_type` | int | 否 | - | 时间维度类型（如 1=日榜、7=周榜） |\n| `date_value` | str | 否 | - | 具体时间值，与 `date_type` 配合使用 |\n| `l1_cid` | str | 否 | - | 一级品类 ID |\n\n---\n\n## 4. 新品榜\n\n```\nGET /api/open/goods/new-product\n```\n\n新上架商品排行榜。上游接口：`/api/goods/newProduct`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | int | 否 | 1 | 页码，≥1 |\n| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |\n| `region` | str | 否 | US | 目标市场 |\n| `order` | str | 否 | \"1,2\" | 排序规则 |\n| `rank_type` | int | 否 | 11 | 榜单类型，固定为 11 |\n| `dt` | str | 否 | - | 日期筛选 |\n| `cid` | str | 否 | - | 品类 ID |\n| `is_cross_border` | str | 否 | - | 是否跨境商品 |\n| `is_sshop` | str | 否 | - | 是否全托管商品 |\n\n---\n\n## 5. 全托管商品榜\n\n```\nGET /api/open/goods/managed-rank\n```\n\nTikTok Shop 全托管（sShop）模式下的热门商品排行。上游接口：`/api/goods/sShopHotList`。\n\n**参数：**\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `page` | in"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1550,"uniquenessScore":42,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:22:05.498Z","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-09T02:22:05.498Z","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-09T10:45:48.626Z","emptyReason":null},"items":[{"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":"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-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","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"}]}}}