Run TikTok Ads from Claude Code

Valkiria reads the TikTok advertiser you connected through the TikTok Business API and gives the assistant campaigns and reports: spend, impressions, clicks, CTR, CPC and conversions. Claude Code adds Valkiria with one command. Because it works in your terminal and repository, it can save what it reads to files, compare it with last week and keep reports next to your code.

Checked:

01

Connect Claude Code in 3 steps

  1. Run the command below in your terminal.
  2. Sign in to Valkiria in the browser window that opens and approve the request.
  3. Start a new session and type: "Get started with Valkiria".
  • The command registers a remote HTTP server; nothing is installed locally and no API key is stored in your repository.
Terminal
claude mcp add --transport http valkiria https://valkiria.pro/mcp

02

What works for TikTok Ads today

Connection: TikTok Business API authorisation: you pick the advertiser in the TikTok portal.

The assistant can read

  • Campaigns with status and budgets.
  • Dated spend, impressions, clicks and conversions per currency for an explicit date range.
  • Campaign performance side by side with the other connected platforms, normalised to the same metrics.

The assistant can propose or request

  • Request a pause or a resume of a campaign.
  • Create a campaign draft inside Valkiria. A campaign that later reaches TikTok is created switched off.
  • Create and update automation rules.
  • Create a monitor that checks the account on a schedule and notifies you or queues a proposal, and schedule a report by email. Neither changes an ad account by itself.

Live integration statusTikTok Ads in Valkiria

03

Prompts to try: TikTok Ads in Claude Code

Copy one, replace the parts in brackets and send it. The assistant picks the tools itself.

  1. Which TikTok campaigns lost click-through rate week over week? Show CTR and spend for both weeks.

  2. Rank my TikTok campaigns by cost per conversion for the last 30 days.

  3. Which TikTok campaigns spent money with zero conversions in the last 7 days?

  4. Compare TikTok with Meta for the last 30 days: spend, clicks and conversions, each in its own currency.

  5. Pull daily TikTok facts for the last 60 days into data/tiktok-daily.csv and flag the days where spend doubled against the 7-day average.

  6. Write briefs/tiktok.md listing the three TikTok campaigns with falling click-through rate, for the creative team.

04

How changes stay safe

  • Sign-in uses OAuth 2.1 with PKCE on valkiria.pro, so the assistant never sees your password.
  • Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
  • A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
  • New campaigns are created paused. Starting new spend and deleting always wait for a person.
  • The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
  • The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
  • You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.

05

Limits

TikTok Ads

  • Spark Ads authorisations and their expiry dates are managed in the Valkiria workspace, not from the assistant.
  • Per-video creative analysis is not exposed to the assistant; it works with campaign-level results.

Claude Code

  • Files the assistant writes are its own work in your repository: Valkiria returns data, it does not create files for you.
  • The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
  • Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
  • Money stays in each account's own currency. Different currencies are not converted or added up.
  • Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.

06

FAQ

Ask Claude Code about your TikTok Ads account

Create a free account, connect an ad account and add the connector. The first pass only reads.

Drag to move. Alt + arrow keys move the button; Alt + Home resets its position.

Cookie Preferences

We use cookies to enhance your experience. Essential cookies are always active. You can manage optional cookies below.

Essential
Analytics
Marketing
Third-Party