Xpersona
Claim this agent
agentCLAWHUBUnverified

AdMapix

Ad intelligence and app analytics assistant for searching ad creatives, analyzing apps, rankings, downloads, revenue, and market insights. Use for 广告素材, 竞品分析...

OpenClaw
View on ClawHub

Rank

62

Safety

84

Downloads

129k

Updated

May 22, 2026

Version

1.0.29

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 129.1K downloads reported by the source. Last updated 5/22/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Adoption signal
129.1K downloadsadoption · observed May 22, 2026
Vendor
Clawhubvendor · observed May 21, 2026
Protocol compatibility
OpenClawcompatibility · observed May 21, 2026
Adoption signal
129K downloadsadoption · observed May 21, 2026
Latest release
1.0.29release · observed May 11, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:admapix
  1. Install using `clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:admapix` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/fly0pants/admapix before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-admapix/snapshot"

Documentation

CLAWHUB

153,966 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: admapix
description: "Ad intelligence and app analytics assistant for searching ad creatives, analyzing apps, rankings, downloads, revenue, and market insights. Use for 广告素材, 竞品分析, 排行榜, 下载量, 收入分析, 市场分析, App分析, 出海分析, ad spy, app intelligence, competitor analysis, and ad distribution."
license: MIT-0
metadata:
  author: fly0pants
  version: "1.0.29"
  openclaw:
    emoji: "🎯"
    primaryEnv: ADMAPIX_API_KEY
    requires:
      env:
        - ADMAPIX_API_KEY
      bins:
        - curl
    env:
      - name: ADMAPIX_API_KEY
        description: "API key for AdMapix data APIs. Get one at https://www.admapix.com"
        required: true
        sensitive: true
      - name: ADMAPIX_DEEP_RESEARCH_TOKEN
        description: "Optional bearer token for the AdMapix Deep Research service, if enabled for the account."
        required: false
        sensitive: true
    network:
      - https://api.admapix.com
      - https://deepresearch.admapix.com
  hermes:
    tags: [ads, app-analytics, market-intelligence, competitor-analysis, ad-creatives]
    category: productivity
---

# AdMapix Intelligence Assistant

**Get started:** Sign up and get your API key at https://www.admapix.com

You are an ad intelligence and app analytics assistant. Help users search ad creatives, analyze apps, explore rankings, track downloads/revenue, and understand market trends — all via the AdMapix API.

**Data disclaimer:** Download/revenue figures are third-party estimates, not official data. Always note this when presenting such data.

## Language Handling / 语言适配

Detect the user's language from their **first message** and maintain it throughout the conversation.

| User language | Response language | Number format | H5 keyword | Example output |
|---|---|---|---|---|
| 中文 | 中文 | 万/亿 (e.g. 1.2亿) | Use Chinese keyword if possible | "共找到 1,234 条素材" |
| English | English | K/M/B (e.g. 120M) | Use English keyword | "Found 1,234 creatives" |

**Rules:**
1. **All text output** (summaries, analysis, table headers, insights, follow-up hints) must match the detected language.
2. **H5 page generation:** When using `generate_page: true`, pass the keyword in the user's language so the generated page displays in the matching language context.
3. **Field name presentation:**
   - Chinese → use Chinese labels: 应用名称, 开发者, 曝光量, 投放天数, 素材类型
   - English → use English labels: App Name, Developer, Impressions, Active Days, Creative Type
4. **Error messages** must also match: "未找到数据" vs "No data found".
5. **Data disclaimers:** "⚠️ 下载量和收入为第三方估算数据" vs "⚠️ Download and revenue figures are third-party estimates."
6. If the user **switches language mid-conversation**, follow the new language from that point on.

## API Access

Base URL: `https://api.admapix.com`

Use the configured `ADMAPIX_API_KEY` value as the `X-API-Key` request header for AdMapix API calls. Keep credentials in the environment or the host agent's secret store; guide users away from pasting API keys into chat and keep key value

README.md

# AdMapix — Ad Intelligence & App Analytics Skill

[中文文档](README_CN.md)

All-in-one ad intelligence assistant. Search ad creatives, analyze apps, explore rankings, track downloads/revenue, and get market insights — all through natural language.

## Features

- **Creative Search** — Search ad creatives by keyword, region, media, creative type, with H5 visual results
- **App Analysis** — Look up any app's details, developer info, and ad creative portfolio
- **Rankings** — App Store / Google Play charts, promotion rankings, download rankings, revenue rankings
- **Download & Revenue** — Track download and revenue trends over time (third-party estimates)
- **Ad Distribution** — Analyze where and how an app advertises (countries, media placements, creative formats)
- **Market Analysis** — Industry-level insights by country, media channel, advertiser, and publisher
- **Deep Dive** — Multi-dimensional reports combining all of the above
- **Deep Research** — AI-powered deep analysis for complex queries (multi-app comparisons, market strategy reports, trend analysis). Automatically triggered for questions requiring 2+ API calls, returns structured HTML reports with key findings

## Install

```bash
npx clawhub install admapix
```

## Setup

1. Go to [www.admapix.com](https://www.admapix.com) to register and get your API Key
2. Configure it using one of these methods:

OpenClaw / ClawHub:

```bash
openclaw config set skills.entries.admapix.apiKey "<your-key>"
```

Generic shell environment:

```bash
export ADMAPIX_API_KEY="<your-key>"
```

## Usage Examples

After setup, just tell your AI assistant:

| Category | Example prompts |
|----------|----------------|
| Creative Search | "Search video ads for puzzle games", "Find casual game creatives in Southeast Asia" |
| App Analysis | "Tell me about Temu", "Who is the developer of TikTok?" |
| Rankings | "App Store free chart US", "Top apps by ad spend this week" |
| Downloads | "How are Temu's downloads trending?", "Compare Temu vs SHEIN downloads" |
| Ad Distribution | "Which countries does Temu advertise in?", "What ad channels does this game use?" |
| Market Analysis | "Which country has the most game ads?", "Who are the top game advertisers?" |
| Deep Dive | "Full ad strategy analysis for Temu", "Compare Temu and SHEIN" |
| Deep Research | "Analyze Temu's ad strategy in Southeast Asia", "Compare top 5 casual games' ad performance" |

Supports both **English** and **Chinese** — the assistant responds in your language.

## Deep Research — AI-Powered Intelligence Reports

For complex analytical queries, AdMapix automatically activates its **Deep Research Framework** — a server-side AI research engine that goes far beyond simple API lookups.

**How it works:**

1. The skill classifies your query by complexity. Simple lookups (single search, single ranking) are handled directly. Anything requiring cross-dimensional analysis is routed to Deep Research.
2. The research engine autonomously plans and executes a mul

_meta.json

{
  "ownerId": "kn7c1c01gzrc3m423t8n840m9s81vj6m",
  "slug": "admapix",
  "version": "1.0.29",
  "publishedAt": 1778473418170
}

references/api-creative.md

# Creative Search API / 素材搜索接口

Base URL: `https://api.admapix.com`
Auth: include the configured AdMapix API key in the `X-API-Key` request header.

---

## 1. Search — 素材搜索

`POST /api/data/search`

Search ad creatives across 5 content types. Supports H5 page generation.

### Content Types

| content_type | Label | Description |
|---|---|---|
| `creative` | 创意组合 | Multi-asset ad bundles (image+video+playable combos) |
| `imagevideo` | 图片/视频 | Individual image or video assets |
| `preplay` | 试玩广告 | Playable/interactive ads |
| `demoad` | 落地页 | Landing pages |
| `document` | 文档素材 | Document-format ads |

### Request Body

```json
{
  "content_type": "creative",
  "keyword": "puzzle game",
  "keyword_type": "",
  "is_new": false,
  "start_date": "2026-02-14",
  "end_date": "2026-03-16",
  "page": 1,
  "page_size": 20,
  "sort_field": "3",
  "sort_rule": "desc",
  "country_ids": [],
  "media_ids": [],
  "adfaction_ids": [],
  "device": [],
  "topic_type": [],
  "languages": [],
  "material_type": "",
  "trade_level1": [],
  "trade_level2": [],
  "trade_level3": [],
  "subject_type": [],
  "product_model": [],
  "product_type": [],
  "selling": [],
  "monetization": [],
  "pay_type": [],
  "company_location": [],
  "campaign_list": [],
  "ad_media_type": [],
  "appeal_type_list": [],
  "interaction_list": [],
  "material_tag": [],
  "material_removal_repeat": false,
  "demoad_formats": [],
  "web_tools": [],
  "material_top_limit": "",
  "gpt_search": null,
  "generate_page": false,
  "delivery": null
}
```

### Key Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| content_type | string | required | One of: creative, imagevideo, preplay, demoad, document |
| keyword | string | "" | Search keyword (app name, ad copy, brand, etc.) |
| keyword_type | string | "" | Keyword match scope (leave empty for default per content_type) |
| start_date | string | 30 days ago | YYYY-MM-DD |
| end_date | string | today | YYYY-MM-DD |
| page | int | 1 | Page number (≥1) |
| page_size | int | 60 | Results per page (1-100) |
| sort_field | string | "3" | "3"=first seen, "4"=days active, "11"=relevance, "15"=impressions |
| sort_rule | string | "desc" | "desc" or "asc" |
| country_ids | string[] | [] | Country codes, e.g. ["US","JP"] — use `ccode` from filter-options |
| media_ids | string[] | [] | Media channel IDs — use `ccode` from filter-options |
| device | string[] | [] | Device filter — use `ccode` from filter-options |
| trade_level1/2/3 | string[] | [] | Industry category filters (hierarchical) |
| product_model | string[] | [] | Product model filter — use `ccode` from filter-options `productModel` (e.g. "1"=non-game, "2"=game) |
| material_type | string | "" | Material format filter ("1"=image, "2"=video). **Only effective for `imagevideo` content type** — ignored by other content types |
| ad_media_type | string[] | [] | Ad media type codes |
| material_removal_repeat | bool | false | Deduplicate similar creatives |
| gpt_search | bo

references/api-distribution.md

# App Distribution API / 应用投放分布接口

Base URL: `https://api.admapix.com`
Auth: include the configured AdMapix API key in the `X-API-Key` request header.

> These endpoints require a `unified_product_id`. Get it from `unified-product-search` first.

---

## 1. App Distribution — 应用推广分布

`POST /api/data/app-distribution`

Analyze an app's ad distribution across different dimensions.

### Request Body

```json
{
  "unified_product_id": "xxx",
  "dim": "country",
  "start_time": "",
  "end_time": "",
  "countries": [],
  "media_ids": [],
  "material_type": "",
  "index_type": 0
}
```

| Parameter | Type | Default | Description |
|---|---|---|---|
| unified_product_id | string | required | Target app ID |
| dim | string | required | Distribution dimension (see below) |
| start_time | string | 30 days ago | YYYY-MM-DD |
| end_time | string | today | YYYY-MM-DD |
| countries | string[] | [] | Country filter |
| media_ids | string[] | [] | Media channel filter |
| material_type | string/int | "" | Material type filter |
| index_type | int | 0 | Index type selector |

### Dimensions

| dim | Description | Returns |
|---|---|---|
| `trend` | 投放趋势 | Time series of ad volume over time |
| `country` | 投放国家分布 | Per-country ad placement distribution |
| `media` | 投放媒体位分布 | Distribution across publisher apps/placements where ads are displayed. **Note:** This returns the specific apps where ads appear (e.g. "Block Blast", "Snake.io", "Solitaire"), NOT ad network names like Facebook/Google. These are the traffic sources/publisher apps carrying the ads. Present them as "投放媒体位" or "广告展示位". |
| `platform` | 平台分布 | iOS vs Android breakdown |
| `type` | 素材类型分布 | Image vs video vs playable distribution |
| `image` | 图片尺寸分布 | Image size/aspect ratio breakdown |
| `video` | 视频时长分布 | Video duration breakdown |
| `lang` | 语言分布 | Ad language distribution |

### Response Examples

**dim=country:**
```json
{
  "list": [
    {"code": "US", "name": "United States", "cnt": 500, "ratio": 0.35},
    {"code": "JP", "name": "Japan", "cnt": 300, "ratio": 0.21}
  ]
}
```

**dim=trend:**
```json
{
  "list": [
    {"date": "2026-03-01", "cnt": 50},
    {"date": "2026-03-02", "cnt": 65}
  ]
}
```

**dim=media (publisher apps / ad placements):**
```json
{
  "list": [
    {"id": "101", "name": "Block Blast Adventure Master", "cnt": 400, "ratio": 0.15},
    {"id": "102", "name": "Snake.io", "cnt": 250, "ratio": 0.09},
    {"id": "103", "name": "Solitaire", "cnt": 180, "ratio": 0.07}
  ]
}
```
These are the apps where the target app's ads are being shown (publisher side). When presenting this data, you can categorize them (e.g. casual games, tools, content apps) to provide more actionable insights.

---

## 2. Distribute Dims — 素材分布维度

`GET /api/data/distribute-dims`

Returns which distribute dimensions are available per content type. This is for the creative-level distribute endpoint (`/api/data/distribute`), not for app-distribution.

### Response

```json
{
  "creative": ["media", "advertise

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "129.1K downloads",
      "href": "https://clawhub.ai/fly0pants/admapix",
      "sourceUrl": "https://clawhub.ai/fly0pants/admapix",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-05-22T06:54:31.856Z",
      "isPublic": true
    },
    {
      "factKey": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "category": "vendor",
      "href": "https://clawhub.ai/fly0pants/admapix",
      "sourceUrl": "https://clawhub.ai/fly0pants/admapix",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-05-21T06:57:34.050Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "protocols",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "category": "compatibility",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-admapix/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-admapix/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-05-21T06:57:34.050Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "traction",
      "label": "Adoption signal",
      "value": "129K downloads",
      "category": "adoption",
      "href": "https://clawhub.ai/fly0pants/admapix",
      "sourceUrl": "https://clawhub.ai/fly0pants/admapix",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-05-21T06:57:34.050Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "latest_release",
      "label": "Latest release",
      "value": "1.0.29",
      "category": "release",
      "href": "https://clawhub.ai/fly0pants/admapix",
      "sourceUrl": "https://clawhub.ai/fly0pants/admapix",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-11T04:23:38.170Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "handshake_status",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "category": "security",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-admapix/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-admapix/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true,
      "metadata": {}
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.29",
      "description": "Security metadata cleanup: declared required env vars and network access, removed hardcoded bearer token, avoided chat-based credential storage, and preserved AdMapix API plus Deep Research workflows.",
      "href": "https://clawhub.ai/fly0pants/admapix",
      "sourceUrl": "https://clawhub.ai/fly0pants/admapix",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-11T04:23:38.170Z",
      "isPublic": true,
      "metadata": {}
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to AdMapix and adjacent AI workflows.