agentleFS
gavasquesgavasques/titanos-agent-skills/skills/amazon-ads-keyword-target-builder/SKILL.md

amazon-ads-keyword-target-builder

Skill0 starsChanged 3 months agoMITView on GitHub

Use when an AI agent needs to choose Amazon Ads keywords, product targets, match types, bids, and negative seeds for Sponsored Products campaigns using Titanos MCP data and safe launch logic.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    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
  2. Very specific:

    Use esta skill junto com amazon-sp-campaign-launcher quando precisar montar a parte de targeting: exact, phrase, broad controlado, ASIN …

    line 20
  3. Very specific:

    Use expand_keywords com 2–5 seeds principais.

    line 127
  4. Very specific:

    Use get_keyword_serp para termos core e capture ASINs com:

    line 147
  5. Distinctive:

    Use negativo exact quando o termo isolado é ruim.

    line 203

≈ “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 Ads Keyword & Target Builder — Titanos MCP

Quando usar / When to Use This Skill

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

  • Precisa escolher keywords, product targets, match types ou bids para SP
  • Pede negativos iniciais antes de lançar campanhas
  • Quer listas de targeting a partir de dados Titanos (sem chute)

Objetivo

Selecionar keywords e product targets bons o suficiente para uma campanha Sponsored Products sem depender de chute.

Use esta skill junto com amazon-sp-campaign-launcher quando precisar montar a parte de targeting: exact, phrase, broad controlado, ASIN targeting e negativos iniciais.

Fontes de dados, em ordem

Priorize dados reais. Não invente demanda.

  1. Histórico Ads da própria conta:
    • ask_ads_report_analyst
    • get_search_term_report
    • get_ads_performance
    • get_advertised_product_report
  2. Recomendações Amazon:
    • list_ads_recommendations
    • get_bid_guidance
  3. Inteligência Titanos/ABA:
    • expand_keywords
    • reverse_asin_keywords
    • thanos_rank_keywords
    • get_keyword_serp
  4. Catálogo/concorrência:
    • lookup_amazon_product
    • Product Finder / SERP / reverse ASIN.
  5. Lógica semântica conservadora, só quando dados forem insuficientes.

Janela de análise

Padrão:

  • 60 dias completos para decisão.
  • Se há pouco volume, expandir para 120 dias.
  • Para lançamento sem histórico, usar mercado/ABA/concorrentes e marcar como teste.

Nunca trate 1 pedido como prova. Para este seller, termo ou ASIN vencedor precisa de 3+ pedidos/conversões.

Classificação de keywords

ClasseExemploUsoMatch
Head corecadeira mochovolume principalEXACT + PHRASE
Long-tail compracadeira mocho sem encostointenção altaEXACT
Profissão/usomocho manicure, mocho esteticistapúblico compradorEXACT + PHRASE
Atributomocho giratorio, mocho pretovariação/atributoPHRASE
Problema/ocasiãocadeira para salão de belezadescobertaPHRASE/BROAD controlado
Irrelevanterodinha cadeira, capa cadeiranegativoNEGATIVE EXACT/PHRASE

Regras de seleção

Exact

Use para:

  • termos principais do produto,
  • termos com 3+ pedidos,
  • termos óbvios de alta intenção,
  • termos de SKU/produto com forte fit.

Bid: 100% do bid calculado.

Phrase

Use para:

  • descoberta controlada,
  • variações de termos core,
  • termos com intenção boa mas volume incerto.

Bid: 60–80% do exact.

Broad

Use com cuidado.

Use apenas quando:

  • conta precisa de descoberta,
  • orçamento separado,
  • negativos iniciais estão claros,
  • usuário aceita teste.

Bid: 40–60% do exact.

Product targeting / PAT

Use para:

  • ASINs concorrentes diretos,
  • produtos substitutos,
  • produtos com preço/rating/página pior que o seu,
  • próprios ASINs para defesa/cross-sell.

Bid: geralmente abaixo do exact, salvo concorrente validado.

Como montar lista inicial

1. Seeds humanas

Extraia do título/listing:

  • substantivo principal,
  • uso,
  • atributo,
  • público,
  • material/cor/tamanho,
  • problema que resolve.

2. Expansão Titanos

Use expand_keywords com 2–5 seeds principais.

Exemplo:

{ "seed": "cadeira mocho", "limit": 50 }

3. Reverse ASIN

Para concorrentes importantes:

{ "asin": "B0XXXXXXXXX", "limit": 30 }

Classifique apenas termos relevantes ao produto.

4. SERP/concorrentes

Use get_keyword_serp para termos core e capture ASINs com:

  • mesmo tipo de produto,
  • preço parecido,
  • reviews medianos/baixos,
  • ranking/BSR relevante,
  • anúncio/posição orgânica forte.

Evite ASINs que não são substitutos reais.

Bids iniciais

Fórmula:

max_cpc = preço × CVR estimado × target_ACOS

Se não tiver CVR histórico:

TipoCVR assumido inicial
Exact core1.5–2.5%
Phrase1.0–1.5%
Broad0.7–1.2%
PAT concorrente0.8–1.5%

Ajuste para baixo quando:

  • listing novo,
  • poucas reviews,
  • estoque baixo,
  • Buy Box incerta,
  • produto caro/consideração longa.

Negativos iniciais

Crie negativos para:

  • acessórios que o produto não vende,
  • peças/reposição,
  • produto de categoria errada,
  • intenção gratuita/download/manual,
  • marcas incompatíveis quando não for conquest.

Exemplo para cadeira/mocho:

capa para cadeira
rodinha cadeira
pistão cadeira
cadeira gamer
cadeira presidente
kit cadeira

Use negativo exact quando o termo isolado é ruim. Use phrase quando toda a família semântica é ruim.

Payload de keyword

sp_keywords usa payload flat:

{
  "campaign_id": "<campaign_id>",
  "ad_group_id": "<ad_group_id>",
  "keyword_text": "cadeira mocho",
  "match_type": "EXACT",
  "bid": 1.5,
  "state": "ENABLED"
}

Valores comuns de match_type:

EXACT
PHRASE
BROAD

Payload de target

sp_targets usa expression array:

{
  "campaign_id": "<campaign_id>",
  "ad_group_id": "<ad_group_id>",
  "expression": [
    { "type": "ASIN_SAME_AS", "value": "B0XXXXXXXXX" }
  ],
  "bid": 0.85,
  "state": "ENABLED"
}

Tipos comuns:

ASIN_SAME_AS
ASIN_CATEGORY_SAME_AS

Score de priorização

Antes de criar, classifique cada item:

ScoreCritério
53+ pedidos ou termo core óbvio com alto fit
4long-tail altamente específico
3termo relevante mas sem prova
2termo amplo/ambíguo
1alto risco de desperdício

Crie primeiro scores 4–5. Scores 2–3 entram em discovery com bid menor. Score 1 vira negativo ou fica fora.

Saída para campaign launcher

Entregue uma tabela final:

targettipomatch/expressionbidmotivoconfiança
cadeira mochokeywordEXACT1.50head core5
mocho manicurekeywordPHRASE0.95uso profissional4
B0XXXXXXXXXproduct targetASIN_SAME_AS0.75concorrente direto4

Erros comuns

  • Misturar keyword com target: keyword vai em sp_keywords; ASIN vai em sp_targets.
  • Enviar KEYWORD_EXACT para sp_targets; isso é errado.
  • Criar broad junto com exact no mesmo ad group sem orçamento separado.
  • Usar ASIN concorrente sem validar se é substituto real.
  • Escalar termo com 1 pedido só.
  • Definir bid sem preço, CVR ou target ACOS.

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.