convez.ai
MCP ServerMarketing & VendasIntermediário
fly0pants

AdMapix MCP

fly0pants/admapix

Inteligência de anúncios e analytics de apps via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a plataforma AdMapix para análise de inteligência publicitária e métricas de apps móveis. Permite buscar criativos de anúncios, analisar estratégias de concorrentes e rastrear rankings em 200+ países através de uma API estruturada.

Instalação

$npx convez-ai fly0pants/admapix

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Análise competitiva de estratégias publicitárias em mobile
  • Pesquisa de criativos de anúncios por palavra-chave e região
  • Rastreamento de métricas de impressões e desempenho de anúncios
  • Inteligência de mercado em múltiplos países

Veredito

MCP server bem estruturado para profissionais de marketing que precisam de dados brutos de publicidade mobile. Exige chave de API válida e é mais voltado para integração com agentes que para uso direto, com instalação clara e documentação técnica adequada.

README

A tradução para o português deste README ainda está na fila.

AdMapix MCP

Raw AdMapix ad creative data for MCP-compatible agents.

AdMapix MCP lets an agent search competitor ad creatives and receive structured JSON data from the AdMapix API. Presentation and analysis workflows are out of scope.

Features

  • Search ad creatives by keyword, app name, advertiser, category, or ad copy
  • Filter by creative type: image, video, playable ad
  • Filter by country or region
  • Filter by date range
  • Sort by first seen, relevance, estimated impressions, or days active
  • Return raw API records with media URLs and metrics

Quick Start

Prerequisite: an AdMapix API key from your admin.

Mac / Linux

git clone https://github.com/fly0pants/admapix.git
bash admapix/install.sh <YOUR_API_KEY>

Windows PowerShell

git clone https://github.com/fly0pants/admapix.git
powershell -ExecutionPolicy Bypass -File admapix\install.ps1 -ApiKey <YOUR_API_KEY>

The installer sets up:

StepWhat it does
1Detects or installs Python 3.10+
2Detects or installs Node.js
3Detects or installs mcporter
4Installs the MCP server in ~/.admapix/
5Configures ~/.mcporter/mcporter.json with ADMAPIX_API_KEY
6Installs the OpenClaw skill

Usage

Ask your MCP-compatible agent for data:

You sayParameters produced
search temu adskeyword="temu"
video ads for puzzle games in the USkeyword="puzzle games", creative_team=["010"], country_ids=["US"]
Southeast Asia casual game ads last 7 daysregion and date filters
sort by impressionssort_field="15", sort_rule="desc"
next pagesame filters, page + 1

Successful calls return raw structured data:

{
  "request": {
    "content_type": "creative",
    "keyword": "puzzle game",
    "page": 1,
    "page_size": 20,
    "sort_field": "3",
    "sort_rule": "desc"
  },
  "totalSize": 1234,
  "page": 1,
  "page_size": 20,
  "list": []
}

MCP Tool

search_creatives parameters:

ParameterTypeDescription
keywordstringSearch keyword
creative_teamstring[]Creative type codes, e.g. ["010"] for video
country_idsstring[]Country codes, e.g. ["US", "JP"]
start_datestringYYYY-MM-DD
end_datestringYYYY-MM-DD
pageintPage number, starting from 1
page_sizeintResults per page, 1-60
sort_fieldstring"3" first seen, "4" days active, "11" relevance, "15" impressions
sort_rulestring"desc" or "asc"
trade_level1string[]Industry category IDs

Manual Setup

python3 -m venv ~/.admapix/.venv
~/.admapix/.venv/bin/pip install mcp httpx pydantic

Configure ~/.mcporter/mcporter.json:

{
  "mcpServers": {
    "admapix": {
      "command": "~/.admapix/.venv/bin/python3 ~/.admapix/server.py",
      "env": {
        "ADMAPIX_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Install the skill:

cp -r skill/ ~/.openclaw/skills/admapix/

Development

python -m compileall src server.py

License

MIT License.

Ver o original no GitHub

Bom para

Relacionados