admapix-mcp 1.0.0

AdMapix MCP Server — AI-powered ad creative search

🎯 AdMapix

AI-Powered Ad Creative Intelligence — Search, Discover, Deliver.
_{Ad(Advertising) + Ma(Map/Material) + Pix(Pixel) — Pixel-level insight into ad creatives.}

中文文档

---

🤔 What is AdMapix?

AdMapix is an MCP Server + OpenClaw Skill that lets AI agents search competitor ad creatives through natural language.

Just tell your agent what you're looking for, and get back a rich H5 results page with videos, images, metrics, and one-click delivery to WeChat.

User: "Search casual game video ads in Southeast Asia"

Agent: 🎯 Found 2,847 ad creatives (page 1)
       👉 http://ad.h5.miaozhisheng.tech/p/abc123

---

✨ Features

🔍 Smart Search Keyword, country, date range, creative type — all expressed in natural language, auto-mapped to API parameters.	🌏 Global Coverage 50+ countries, 10+ region shortcuts, filterable by industry category.	📊 Rich Results Auto-generated H5 pages with video playback, image gallery, ad metrics, and impression data.
📱 WeChat Delivery One-tap "Send to Chat" — delivers video files directly into WeChat conversations.	🤖 Agent-Native Built as MCP Server, works with any MCP-compatible agent (OpenClaw, Claude Code, etc).	⚡ Zero Config One install script handles Python, Node.js, mcporter, and config — fully automated.

---

🚀 Quick Start

Prerequisite: An 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 automatically:

Step	What it does
1	Detects or installs Python 3.10+
2	Detects or installs Node.js
3	Detects or installs mcporter
4	Sets up MCP Server in ~/.admapix/
5	Configures ~/.mcporter/mcporter.json
6	Installs OpenClaw Skill to ~/.openclaw/skills/

That's it. Start chatting with your agent and search away.

---

🎯 Usage

Through your AI agent (OpenClaw, etc.), just say:

You say	What happens
"search temu ads"	Search by keyword
"video only"	Filter by creative type
"in Southeast Asia"	Filter by region
"sort by impressions"	Sort by impression
"last 7 days"	Filter by date range
"next page"	Paginate

---

🔧 Manual Setup

If you prefer manual configuration over the install script

1. Install dependencies

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

2. Configure ~/.mcporter/mcporter.json

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

3. Install the Skill

cp -r skill/ ~/.openclaw/skills/ad-creative-search/

---

🏗️ Architecture

User (WeChat / Agent)
  → AI Agent (OpenClaw)
    → mcporter call 'admapix.search_creatives(...)'
      → MCP Server (Python, STDIO)
        → AdMapix API
          → H5 Result Page ← User views in browser
          → Video Delivery  ← User receives in WeChat

---

📄 License

MIT License — free to use, modify, and distribute.

---

AdMapix — Ad intelligence at your fingertips.

Built by Miaozhisheng