🎯 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

🚀 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:

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

🎯 Usage

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

🔧 Manual Setup

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

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

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.