AdMapix MCP
fly0pants/admapix
Inteligência de anúncios e analytics de apps via MCP
Ver no GitHubServidor 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/admapix1 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
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:
| Step | What it does |
|---|---|
| 1 | Detects or installs Python 3.10+ |
| 2 | Detects or installs Node.js |
| 3 | Detects or installs mcporter |
| 4 | Installs the MCP server in ~/.admapix/ |
| 5 | Configures ~/.mcporter/mcporter.json with ADMAPIX_API_KEY |
| 6 | Installs the OpenClaw skill |
Usage
Ask your MCP-compatible agent for data:
| You say | Parameters produced |
|---|---|
search temu ads | keyword="temu" |
video ads for puzzle games in the US | keyword="puzzle games", creative_team=["010"], country_ids=["US"] |
Southeast Asia casual game ads last 7 days | region and date filters |
sort by impressions | sort_field="15", sort_rule="desc" |
next page | same 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:
| Parameter | Type | Description |
|---|---|---|
keyword | string | Search keyword |
creative_team | string[] | Creative type codes, e.g. ["010"] for video |
country_ids | string[] | Country codes, e.g. ["US", "JP"] |
start_date | string | YYYY-MM-DD |
end_date | string | YYYY-MM-DD |
page | int | Page number, starting from 1 |
page_size | int | Results per page, 1-60 |
sort_field | string | "3" first seen, "4" days active, "11" relevance, "15" impressions |
sort_rule | string | "desc" or "asc" |
trade_level1 | string[] | 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.