Tiktok Ad Research
Pull paid TikTok ad creatives and patterns from PostPlus-hosted collections to brief hooks, CTAs, and competitor paid campaigns—not organic creator hunts.
Overview
TikTok Ad Research is an agent skill for the Launch phase that collects paid TikTok ad intelligence via PostPlus without mixing in organic creator or music workflows.
Install
npx skills add https://github.com/postplusai/postplus-skills --skill tiktok-ad-researchWhat is this skill?
- Scopes work to paid TikTok Creative Center / ad-library style datasets only
- Routes hosted collects via collection key tiktok-ads-top and schemaVersion 1 envelopes
- Primary CLI: postplus research collect with skill, collection-key, input, and output flags
- Default workflow: classify task shape, narrow first-pass request, then expand only if needed
- Explicit guardrails: no organic creator discovery, comments research, or TikTok music workflows
- Released hosted collection key: tiktok-ads-top
- Hosted input requires schemaVersion 1 execution envelope
Adoption & trust: 1 installs on skills.sh; 8 GitHub stars; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
You need proven paid TikTok hooks and competitor ad examples but keep accidentally researching organic creators or the wrong PostPlus collection.
Who is it for?
Indie marketers and founders running TikTok paid tests who already use PostPlus CLI and want agent-guided collection envelopes.
Skip if: Organic TikTok creator discovery, comment sentiment studies, TikTok music trends, or teams without PostPlus hosted collect access.
When should I use this skill?
User wants paid TikTok ad creatives, top ads by category/country/objective, competitor paid hooks, or ad briefs from ad examples—not organic discovery.
What do I get? / Deliverables
You get a focused tiktok-ads-top collect output you can translate into ad briefs, hook language, and CTA tests for the next creative iteration.
- raw-output.json from postplus research collect
- Structured paid ad examples and optional ad-level metrics for briefing
Recommended Skills
Journey fit
Paid ad intelligence sits in Launch when you are choosing channels, angles, and creative references before scaling spend. Distribution subphase covers ad platforms and outbound creative systems where TikTok paid examples directly inform creatives.
How it compares
Use instead of generic social listening skills when the job is paid ad library patterns, not influencer outreach.
Common Questions / FAQ
Who is tiktok-ad-research for?
Solo builders and small teams running paid TikTok campaigns who want PostPlus-backed ad creative research inside an agent workflow.
When should I use tiktok-ad-research?
Use it in Launch distribution when briefing new paid creatives or studying competitor top ads; in Grow content when refreshing hooks for lifecycle campaigns—never for organic creator scouting.
Is tiktok-ad-research safe to install?
It calls PostPlus APIs and writes collect output to disk; review the Security Audits panel on this page, rotate API keys, and avoid committing raw envelopes with secrets.
SKILL.md
READMESKILL.md - Tiktok Ad Research
# TikTok Ad Research Use this skill for paid TikTok ad intelligence, not organic creator or content discovery. Apply shared rulebook and user-guidance rules from `postplus-shared`. ## Task Shapes Use this skill when the user wants to: - find paid TikTok ad creatives that are performing well, - inspect top ads for a category, country, region, language, or objective, - study competitor paid hooks, selling points, and CTAs, - turn ad examples into ad briefs or creative implications. Do not use this skill for creator discovery, community comments research, organic content lane mapping, or TikTok music workflows. ## Collection Key Routing Released hosted collection key: - `tiktok-ads-top`: top paid ad examples and optional ad-level metrics. The hosted input must be a `schemaVersion: 1` execution envelope whose `input` field contains the paid-ad collection request. Primary command: ```bash postplus research collect \ --skill tiktok-ad-research \ --collection-key tiktok-ads-top \ --input <hosted-envelope.json> \ --output <raw-output.json> ``` ## Default Workflow 1. Classify the request into a paid-ad task shape. 2. Build a narrow first-pass request for the category, region, objective, or competitor scope. 3. Wrap the request under `schemaVersion: 1` + `input`. 4. Run the hosted collection and normalize the result into observed ad facts. 5. Separate observed ad facts from inferred creative implications. Keep raw datasets and intermediate files under `.postplus/tiktok-ads/`; keep final shortlists, summaries, or briefs where the user can inspect them. ## Good Output Return top brands or advertisers, dominant objectives, repeated hook and offer language, CTA patterns, region or language scope, duration distribution, and which metrics were actually present in the sample. ## Failure Modes - Stop if the request is organic creator/content research; route to `tiktok-research` instead. - Stop on missing required input, unsupported key, missing auth, unavailable hosted service, or stable network failure. - Do not invent fallback execution paths, private backend calls, or web-search replacements for paid ad collection. ## Handoff - Organic TikTok benchmark comparison -> `tiktok-research`. - Ad creative review after humans inspect outputs -> `creative-qa`. - Shot-level or spoken-line breakdown -> `video-analysis`. ## Public Command Boundary - Choose the smallest matching command or workflow from the user input and run it directly. - Readiness diagnostics: `postplus doctor --skill tiktok-ad-research`. - If an owned CLI or script command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools. - Use `postplus research schema --collection-key tiktok-ads-top --json` only when constructing or repairing an unknown request shape. - Hosted collection: `postplus research collect --skill tiktok-ad-research --collection-key tiktok-ads-top --input <hosted-envelope.json> --output <collection-result.json>`. - Resume a pending collection: `postplus research collect --run-handle <runHandle> --output <collection-result.json>`. - Keep the first pass bounded; expand only after inspecting the first result. - If the CLI returns a quote-confirmation challenge, run `postplus quote confirm --json --challenge-file <challenge.json>` and retry with the returned token.