PACKAGE EXPLORERView in registry

admapix-mcp

PyPI

AdMapix MCP Server — AI-powered ad creative search

Versions collected1

Direct dependencies3From release 1.0.0

Last observed20 Oct, 19:39 UTC

README

Version 1.0.0 documentation

🎯 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

Install dependencies

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": {
        "API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
1.0.0	13 Mar 2026	3

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING

fly0pants/admapix

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 19:39 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:606d926e0a853ac6ee97019d3a2193af78b5bba993861f1d59bcdf3bc746b94f