How do I install the Adspirer Tiktok Ads skill?

Run npx skillmds@latest add amekala/adspirer-tiktok-ads in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Adspirer Tiktok Ads safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Adspirer Tiktok Ads?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Adspirer Tiktok Ads free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Adspirer Tiktok Ads?

amekala (@amekala) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Adspirer Tiktok Ads by amekala — Agent Skill

Name: Adspirer Tiktok Ads
Rating: 4.2 (5 reviews)
Author: amekala

Adspirer Tiktok Ads

Create and manage TikTok Ads through Adspirer — in-feed video, Spark Ads, carousel, app promotion, and conversions campaigns. Use for anything on TikTok. Covers the pixel-placement rule that causes most TikTok failures, the unsupported single-image ad, and per-currency budget floors.

amekala Updated Sep 10, 2026

File contents

TikTok Ads

Everything on TikTok goes through the tiktok_ads router. Follow adspirer-mcp for the two-step.

Account parameter: advertiser_id, as a string. Budgets are in the account's currency.

TikTok rejects invalid combinations of objective, optimization goal, and tracking rather than correcting them. Check references/validity-matrix.md before you build an ad group. A rejected call fails the same way on retry.

The pixel rule — read this before anything else

Where the pixel goes depends on the objective:

Objective is CONVERSIONS, WEB_CONVERSIONS, PRODUCT_SALES, or SHOP_PURCHASES → set pixel_id on the ad group, and optimization_event becomes required.
Any other objective → the pixel goes on the ad as tracking_pixel_id. An ad-group pixel_id is rejected with PIXEL_ID_NOT_ALLOWED_FOR_OBJECTIVE.

This single rule is the most common TikTok error we see. A traffic campaign with a pixel on the ad group fails every time.

There is no single-image in-feed ad

TikTok does not support one static image as an in-feed ad. It returns error 40002. Use:

a video ad (create_tiktok_video_campaign),
a Spark Ad boosting an existing organic post (tiktok_item_id), or
a carousel, 2–10 images with music (create_tiktok_carousel_card).

If the user only has one image, say so and offer the carousel or a video.

Uploads fail quietly

After uploading a video, check video_id. If it comes back as the string "None", the upload failed — it is not null and it will not error. Re-upload. Never create an ad with video_id: "None".

Budgets have per-currency floors

USD 20 · EUR 20 · GBP 15 · CAD 25 · AUD 30 · SGD 25 · BRL 100 · HKD 150 · MXN 350 · ZAR 500 · TWD 600 · PHP 1000 · INR 1500 · JPY 2500. Lifetime budgets floor at roughly 7× the daily figure. The full table is in the reference. Below the floor TikTok replies "Your budget setting must not be less than X."

Objectives

Valid: REACH, RF_REACH, VIDEO_VIEWS, ENGAGEMENT, TRAFFIC, APP_INSTALL, APP_PROMOTION, LEAD_GENERATION, CONVERSIONS, WEB_CONVERSIONS, PRODUCT_SALES, SHOP_PURCHASES, CATALOG_SALES.

Some accounts lack the permission scope for a given objective and get a generic "objective isn't supported." Run explain_tiktok_objective to check before building.

Dependencies worth knowing up front:

promotion_type is required unless the objective is REACH, RF_REACH, VIDEO_VIEWS, or ENGAGEMENT.
REACH and RF_REACH require frequency and frequency_schedule (3 impressions / 7 days is a sane start).
APP_INSTALL and APP_PROMOTION require app_id and operating_systems — one OS per ad group.
secondary_optimization_event is only valid when optimization_goal is INSTALL or VALUE.

Call-to-action

LEARN, VISIT, and GO are rejected. Use LEARN_MORE, SHOP_NOW, DOWNLOAD_NOW, SIGN_UP, GET_QUOTE, BOOK_NOW, or INSTALL_NOW.

Build order

Campaign → add_tiktok_ad_group → add_tiktok_ad. Campaigns are created paused.

You need an identity (the account the ad posts as) — list_tiktok_identities. Without one, the ad has no author and creation fails.

References

references/validity-matrix.md — the full objective × pixel × optimization matrix, currency floors, and CTA list. Read it before building an ad group.

---name: adspirer-tiktok-adsdescription: Create and manage TikTok Ads through Adspirer — in-feed video, Spark Ads, carousel, app promotion, and conversions campaigns. Use for anything on TikTok. Covers the pixel-placement rule that causes most TikTok failures, the unsupported single-image ad, and per-currency budget floors.---# TikTok AdsEverything on TikTok goes through the `tiktok_ads` router. Follow `adspirer-mcp` for the two-step.Account parameter: `advertiser_id`, as a **string**. Budgets are in the account's currency.TikTok rejects invalid combinations of objective, optimization goal, and tracking rather thancorrecting them. **Check `references/validity-matrix.md` before you build an ad group.** A rejectedcall fails the same way on retry.## The pixel rule — read this before anything elseWhere the pixel goes depends on the objective:- Objective is `CONVERSIONS`, `WEB_CONVERSIONS`, `PRODUCT_SALES`, or `SHOP_PURCHASES` → set `pixel_id` on the **ad group**, and `optimization_event` becomes required.- **Any other objective** → the pixel goes on the **ad** as `tracking_pixel_id`. An ad-group `pixel_id` is rejected with `PIXEL_ID_NOT_ALLOWED_FOR_OBJECTIVE`.This single rule is the most common TikTok error we see. A traffic campaign with a pixel on the adgroup fails every time.## There is no single-image in-feed adTikTok does not support one static image as an in-feed ad. It returns error 40002. Use:- a **video** ad (`create_tiktok_video_campaign`),- a **Spark Ad** boosting an existing organic post (`tiktok_item_id`), or- a **carousel**, 2–10 images with music (`create_tiktok_carousel_card`).If the user only has one image, say so and offer the carousel or a video.## Uploads fail quietlyAfter uploading a video, check `video_id`. If it comes back as the **string `"None"`**, the uploadfailed — it is not null and it will not error. Re-upload. Never create an ad with `video_id: "None"`.## Budgets have per-currency floorsUSD 20 · EUR 20 · GBP 15 · CAD 25 · AUD 30 · SGD 25 · BRL 100 · HKD 150 · MXN 350 · ZAR 500 ·TWD 600 · PHP 1000 · INR 1500 · JPY 2500. Lifetime budgets floor at roughly 7× the daily figure.The full table is in the reference. Below the floor TikTok replies "Your budget setting must not beless than X."## ObjectivesValid: `REACH`, `RF_REACH`, `VIDEO_VIEWS`, `ENGAGEMENT`, `TRAFFIC`, `APP_INSTALL`, `APP_PROMOTION`,`LEAD_GENERATION`, `CONVERSIONS`, `WEB_CONVERSIONS`, `PRODUCT_SALES`, `SHOP_PURCHASES`,`CATALOG_SALES`.Some accounts lack the permission scope for a given objective and get a generic "objective isn'tsupported." Run `explain_tiktok_objective` to check before building.Dependencies worth knowing up front:- `promotion_type` is required unless the objective is `REACH`, `RF_REACH`, `VIDEO_VIEWS`, or `ENGAGEMENT`.- `REACH` and `RF_REACH` require `frequency` and `frequency_schedule` (3 impressions / 7 days is a sane start).- `APP_INSTALL` and `APP_PROMOTION` require `app_id` and `operating_systems` — one OS per ad group.- `secondary_optimization_event` is only valid when `optimization_goal` is `INSTALL` or `VALUE`.## Call-to-action`LEARN`, `VISIT`, and `GO` are rejected. Use `LEARN_MORE`, `SHOP_NOW`, `DOWNLOAD_NOW`, `SIGN_UP`,`GET_QUOTE`, `BOOK_NOW`, or `INSTALL_NOW`.## Build orderCampaign → `add_tiktok_ad_group` → `add_tiktok_ad`. Campaigns are created **paused**.You need an identity (the account the ad posts as) — `list_tiktok_identities`. Without one, the adhas no author and creation fails.## References- `references/validity-matrix.md` — the full objective × pixel × optimization matrix, currency floors, and CTA list. Read it before building an ad group.

Frequently asked questions