agentleFS
Sign inStart free
gavasquesgavasques/titanos-agent-skills/skills/amazon-dsp/SKILL.md

amazon-dsp

Skill0 starsChanged 3 months agoMITView on GitHub

Amazon DSP via MCP Titanos — leitura get_dsp_*, write create/update/delete_dsp_resources. Performance histórica via ask_ads_report_analyst ainda não cobre DSP no warehouse; use API live + skill Amazon-Ads para SP. Use para ler ou escrever recursos DSP (não Sponsored Products).

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use esta skill quando o usuário / Use this skill when the user:

    line 11

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Amazon DSP — MCP Titanos

Quando usar / When to Use This Skill

Use esta skill quando o usuário / Use this skill when the user:

  • Pede para ler ou escrever campanhas Amazon DSP
  • Precisa de advertisers, orders ou line items DSP via MCP
  • Menciona DSP (programmatic); Sponsored Products usa amazon-ads

DSP (programmatic) no Titanos: leitura/escrita via Advertising API em perfis agency (account_type agency no perfil Ads).

Pré-requisitos

  1. OAuth Amazon Ads ativo + scope ads:campaigns:read / write
  2. list_amazon_ads_integration_accounts — filtrar perfil agency
  3. connection_id + profile_id em todas as chamadas
  4. Identificar advertiser_id DSP antes de campanhas/line items

Hierarquia (API Titanos)

profile (agency)
  → get_dsp_campaigns        (filters.advertiser_id)
  → get_dsp_ad_groups        (advertiser_id + campaign_id opcional)
  → get_dsp_line_items       (advertiser_id + ad_group_id)
  → get_dsp_creatives        (advertiser_id — nível advertiser)

Targets DSP: não há tool dsp_targets separada no MCP v1 — use line items e creatives.

Tools

AçãoTool
Listar campanhas / ad groups / line items / creativesget_dsp_*
Atualizar entidadesupdate_dsp_resources (dsp_campaigns, dsp_ad_groups, dsp_line_items, dsp_creatives)
Criarcreate_dsp_resources
Desassociar creative↔ad groupdelete_dsp_resources (tipo dsp_creatives)

Sempre dry_run: true antes de write.

Performance e relatórios — gap importante

A skill AdPros original usa ask_report_analyst com report types dsp_campaign_performance, dsp_products, etc.

No Titanos hoje: ask_ads_report_analyst cobre apenas datasets Sponsored Products (ads_campaign_performance, ads_search_terms, ads_placement, ads_advertised_product). Não inclui warehouse DSP.

Alternativas:

  • Métricas agregadas recentes: combinar respostas de get_dsp_campaigns / line items (campos de status/budget quando expostos pela API)
  • Para análise NL profunda DSP: aguardar ingestão warehouse ou export manual + análise offline
  • Não inventar NTB%, halo ou geography sem dados reais

Quando o warehouse DSP existir, atualizar esta skill para usar ask_ads_report_analyst com os novos datasets.

Fluxos (estrutura + operação)

Health check estrutural

  1. Resolver agency profile
  2. get_dsp_campaigns com advertiser_id
  3. Resumir campanhas ENABLED vs PAUSED

Browse line items de uma campanha

  1. get_dsp_ad_groups (campaign_id)
  2. get_dsp_line_items (ad_group_id)

Creatives do advertiser

get_dsp_creatives — biblioteca no nível advertiser; cruzar com ad groups manualmente.

Pitfalls Titanos

  • Não misturar advertisers numa mesma query
  • DSP write ≠ pausar Sponsored Products — especificar plataforma
  • Lag 1–3 dias em relatórios Amazon (quando warehouse existir)
  • "Order" no relatório DSP ≈ campanha em outras interfaces

Dicas

  • list_brands para contexto multi-conta
  • PPC memory: get_entity_history inclui dsp_campaigns em mutações registradas
  • SP performance: skill Amazon-Ads + ask_ads_report_analyst

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free