# Ecommerce Chuhaijiang Tiktok Ads

> Research public TikTok ads and creative assets through Chuhaijiang and NexScope.

- Skill: `nexscope-ai/ecommerce-chuhaijiang-tiktok-ads` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add nexscope-ai/ecommerce-chuhaijiang-tiktok-ads`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nexscope-ai/ecommerce-chuhaijiang-tiktok-ads/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: nexscope-ai (https://skillmd.com/u/nexscope-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nexscope-ai/ecommerce-chuhaijiang-tiktok-ads

---


# Chuhaijiang TikTok Ad and Creative Intelligence

## Scope

Ad search and detail, related products, creative search and detail, storyboard analysis, and vector metadata.

Public creative intelligence only. It does not authorize an ad account, create campaigns, spend budget, or publish content.

Read [references/api.md](references/api.md) for the authoritative source-derived request and response contract.

## Operations

| Script | NexScope route |
|---|---|
| `chuhaijiang_ad_detail.py` | `POST /api/v1/tools/research/chuhaijiang/ad-creative/ads/detail` |
| `chuhaijiang_ad_related_products.py` | `POST /api/v1/tools/research/chuhaijiang/ad-creative/ads/related-products` |
| `chuhaijiang_ad_search.py` | `POST /api/v1/tools/research/chuhaijiang/ad-creative/ads/search` |
| `chuhaijiang_creative_detail.py` | `POST /api/v1/tools/research/chuhaijiang/ad-creative/creatives/detail` |
| `chuhaijiang_creative_search.py` | `POST /api/v1/tools/research/chuhaijiang/ad-creative/creatives/search` |

## Authentication and safety

- Set `NEXSCOPE_PROXY_BASE` and `NEXSCOPE_API_KEY`. Send the NexScope key as `Authorization: Bearer <key>`.
- No marketplace account authorization is required; these operations read public-market data.
- Provider credentials and upstream tokens remain backend-owned. Never accept, print, or persist them.
- Treat HTTP 401 as NexScope authentication failure and HTTP 402 as insufficient NexScope credits.
- Do not substitute another account, market, region, creator, product, or operation after an authorization or ambiguous network failure.
- This operation consumes credits. Preserve `X-Cost-Token` and `X-Cost-Credit` from response headers as server-reported billing metadata.

## Workflow

1. Identify the exact operation, market/account context, filters, dates, pagination, and requested output.
2. Validate required fields, types, enums, ranges, and operation-specific limits against `references/api.md` before any request.
3. Explain that additional pages, markets, or operations may consume more credits and obtain approval before a paid call.
4. Run only the selected entry script, for example: `python scripts/chuhaijiang_ad_detail.py '<JSON parameters>' --no-cache` when the script supports that flag.
5. Preserve the full response under `nexscope/<date>/<session>/data`; return a concise summary and the saved path.
6. On an ambiguous timeout or upstream failure, do not retry automatically. Report the trace ID and reconcile state first.

## Output rules

- Distinguish the NexScope transport envelope from the nested business response.
- Report only returned facts. Preserve absent values as unknown and keep provider-specific metric definitions intact.
- Never expose API keys, provider tokens, presigned URL query strings, internal account records, or raw secrets.
- Do not submit feedback or make any unrelated external mutation unless the user explicitly requests it.


## Authentication

Set the `NEXSCOPE_API_KEY` environment variable. If credentials are missing or expire, visit [https://www.nexscope.ai/help/skills-external-access?co-from=skillNS](https://www.nexscope.ai/help/skills-external-access?co-from=skillNS) to top up credits.

