AGENT SKILL

pm-amazon-ads

Amazon Ads 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-amazon-ads
description
Amazon Ads connector knowledge and safe action guide.

03 SKILL.md 正文

pm-amazon-ads

Purpose

Reads Amazon Advertising profiles, Sponsored Products campaigns, ad groups, product ads, keywords, negative keywords, and portfolios via the Amazon Ads API using a Login with Amazon (LWA) refresh-token grant. Read-only.

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

  • base_url
  • max_pages
  • page_size
  • profile_id
  • token_url
  • client_id (secret) (required)
  • client_secret (secret) (required)
  • refresh_token (secret) (required)

ETL Streams

  • profiles:
    • primary key: profile_id
    • fields: account_id(string), account_name(string), account_type(string), country_code(string), currency_code(string), daily_budget(number), marketplace_string_id(string), profile_id(integer), timezone(string)
  • campaigns:
    • primary key: campaign_id
    • fields: campaign_id(integer), campaign_type(string), daily_budget(number), end_date(string), name(string), portfolio_id(integer), premium_bid_adjustment(boolean), start_date(string), state(string), targeting_type(string)
  • ad_groups:
    • primary key: ad_group_id
    • fields: ad_group_id(integer), campaign_id(integer), default_bid(number), name(string), state(string)
  • portfolios:
    • primary key: portfolio_id
    • fields: in_budget(boolean), name(string), portfolio_id(integer), state(string)
  • keywords:
    • primary key: keyword_id
    • fields: ad_group_id(integer), bid(number), campaign_id(integer), keyword_id(integer), keyword_text(string), match_type(string), state(string)
  • product_ads:
    • primary key: ad_id
    • fields: ad_group_id(integer), ad_id(integer), asin(string), campaign_id(integer), serving_status(string), sku(string), state(string)
  • negative_keywords:
    • primary key: keyword_id
    • fields: ad_group_id(integer), campaign_id(integer), keyword_id(integer), keyword_text(string), match_type(string), state(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite

Security

  • read risk: external Amazon Ads API read of profile, campaign, ad group, product ad, keyword, negative keyword, and portfolio data
  • approval: none; read-only, no reverse-ETL write surface
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect amazon-ads

Inspect as structured JSON

pm connectors inspect amazon-ads --json

Agent Rules

  • Run pm connectors inspect amazon-ads 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