AGENT SKILL

pm-tiktok-marketing

TikTok Marketing connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-tiktok-marketing
description
TikTok Marketing connector knowledge and safe action guide.

03 SKILL.md 正文

pm-tiktok-marketing

Purpose

Reads TikTok Business advertisers, campaigns, ad groups, and ads through the TikTok Marketing (Business) API.

Icon

Capabilities

  • check=true catalog=true read=true write=false query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • advertiser_id
  • base_url
  • access_token (secret) (required)

ETL Streams

  • advertisers:
    • primary key: advertiser_id
    • fields: advertiser_id(string), advertiser_name(string), company(string), country(string), currency(string), role(string), status(string), timezone(string)
  • campaigns:
    • primary key: campaign_id
    • cursor: modify_time
    • fields: advertiser_id(string), budget(number), budget_mode(string), campaign_id(string), campaign_name(string), create_time(string), modify_time(string), objective_type(string), operation_status(string)
  • adgroups:
    • primary key: adgroup_id
    • cursor: modify_time
    • fields: adgroup_id(string), adgroup_name(string), advertiser_id(string), budget(number), budget_mode(string), campaign_id(string), create_time(string), modify_time(string), operation_status(string), placement_type(string)
  • ads:
    • primary key: ad_id
    • cursor: modify_time
    • fields: ad_id(string), ad_name(string), adgroup_id(string), advertiser_id(string), call_to_action(string), campaign_id(string), create_time(string), modify_time(string), operation_status(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped

Security

  • read risk: external TikTok Business API read of advertiser and campaign management data
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Command Surface

  • Declared tiktok-marketing API commands.
  • Usage: pm tiktok-marketing <command> [flags]
  • Global flags:
    • --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.
  • Other Commands
    • operations get-advertiser-info - Declared etl: GET /advertiser/info/. [intent=etl availability=partial]; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.get-advertiser-info-1 has no declaration-owned executable etl route.
    • operations get-campaign-get - Declared etl: GET /campaign/get/. [intent=etl availability=partial]; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.get-campaign-get-2 has no declaration-owned executable etl route.
    • operations get-adgroup-get - Declared etl: GET /adgroup/get/. [intent=etl availability=partial]; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.get-adgroup-get-3 has no declaration-owned executable etl route.
    • operations get-ad-get - Declared etl: GET /ad/get/. [intent=etl availability=partial]; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.get-ad-get-4 has no declaration-owned executable etl route.
    • operations get-report-integrated-get - Declared direct read: GET /report/integrated/get/. [intent=direct_read availability=partial]; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.get-report-integrated-get-5 has no declaration-owned executable stream, direct-read, binary, or status route.; flags: --page, --page-cursor
    • operations post-campaign-create - Declared direct write: POST /campaign/create/. [intent=direct_write availability=partial]; approval: direct_write commands require plan, preview, approval, execute; risk: Declared provider mutation: POST /campaign/create/.; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.post-campaign-create-6 has no declaration-owned executable direct_write route.
    • operations post-campaign-update-status - Declared direct write: POST /campaign/update/status/. [intent=direct_write availability=partial]; approval: direct_write commands require plan, preview, approval, execute; risk: Declared provider mutation: POST /campaign/update/status/.; notes: Blocked: locked source operation tiktok-marketing.local-api-surface.post-campaign-update-status-7 has no declaration-owned executable direct_write route.

Commands

Inspect as a manual

pm connectors inspect tiktok-marketing

Inspect as structured JSON

pm connectors inspect tiktok-marketing --json

Agent Rules

  • Run pm connectors inspect tiktok-marketing before creating credentials or plans.
  • Use --json only when the caller needs structured output; use the manual for human-readable guidance.
  • Never ask the user to paste secret values into chat.

04 同仓库更多 Skills