SkillAgentSearch skills...

adclaw

Ad creative search assistant. Results displayed via ad.h5.miaozhisheng.tech. Triggers on keywords like: 找素材, 搜广告, 广告视频, 创意素材, 竞品广告, ad creative, search ads, find creatives, competitor ads, ad spy.

Install / Use

npx skills add LeoYeAI/openclaw-master-skills --skill adclaw

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Category

Marketing

Supported Platforms

Universal

Our assessment of adclaw

adclaw scores 88/100 on our quality scale, 315th of 642 Marketing skills we index (top 50%).

Its SKILL.md is 7.7 KB long, well organised into 14 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.

With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
14/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-01 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

adclaw compared with similar skills

All 4 of these similar skills score higher than adclaw; compare them before choosing.

SkillScoreStarsUpdatedFormat
adclaw (this skill)by LeoYeAI882.1k4mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server
crawl4aiby unclecode10087.4k3d agoMCP Server

Frequently asked questions

How do I install adclaw?
Run npx skills add LeoYeAI/openclaw-master-skills --skill adclaw. The install tabs above show the steps for each supported agent.
Which AI agents does adclaw work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is adclaw safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is adclaw still maintained?
The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: adclaw description: "Ad creative search assistant. Results displayed via ad.h5.miaozhisheng.tech. Triggers on keywords like: 找素材, 搜广告, 广告视频, 创意素材, 竞品广告, ad creative, search ads, find creatives, competitor ads, ad spy." metadata: {"openclaw":{"emoji":"🎯","primaryEnv":"ADCLAW_API_KEY"}}

Ad Creative Search Assistant

You are an ad creative search assistant. Help users search competitor ad creatives via the AdClaw API.

Language handling: Detect the user's language and respond in the same language. Support both Chinese and English inputs for all parameters (see references/param-mappings.md for bilingual mappings).

Data Source

Fetch data by calling the AdClaw API via curl.

API endpoint: https://ad.h5.miaozhisheng.tech/api/data/search Authentication: Header X-API-Key: $ADCLAW_API_KEY (environment variable, managed by the platform)

Request Format

POST JSON, example:

curl -s -X POST "https://ad.h5.miaozhisheng.tech/api/data/search" \
  -H "X-API-Key: $ADCLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type":"creative","keyword":"puzzle game","page":1,"page_size":20,"sort_field":"3","sort_rule":"desc","generate_page":true}'

Request Parameters

| Parameter | Type | Default | Description | |---|---|---|---| | keyword | string | "" | Search keyword (app name, ad copy, etc.) | | creative_team | string[] | omit=all | Creative type code, e.g. ["010"] for video | | country_ids | string[] | omit=global | Country codes, e.g. ["US","GB"] | | start_date | string | 30 days ago | Start date YYYY-MM-DD | | end_date | string | today | End date YYYY-MM-DD | | sort_field | string | "3" | Sort: "11" relevance / "15" est. impressions / "3" first seen / "4" days active | | sort_rule | string | "desc" | Direction: "desc" / "asc" | | page | int | 1 | Page number | | page_size | int | 20 | Results per page (max 60) | | trade_level1 | string[] | omit=all | Industry category IDs | | content_type | string | "creative" | Fixed value, required | | generate_page | bool | true | Fixed true, generates H5 result page |

Interaction Flow

Follow these steps strictly after receiving a user request:

Step 1: Parse Parameters

Extract all possible parameters from the user's natural language. Read references/param-mappings.md for complete bilingual mapping rules to convert user expressions into API parameters.

Quick reference (supports both Chinese and English):

| User might say | Parameter | Mapping | |---|---|---| | "puzzle game", "temu" | keyword | Extract keyword directly | | "video" / "视频", "image" / "图片", "playable" / "试玩" | creative_team | Look up mapping table → code list | | "Southeast Asia" / "东南亚", "US" / "美国", "Japan & Korea" / "日韩" | country_ids | Look up region → country code mapping | | "last week" / "最近一周", "last month" / "上个月" | start_date / end_date | Calculate dates (based on today) | | "most relevant" / "最相关" | sort_field + sort_rule | Look up sort mapping | | "most popular" / "最热", "most impressions" / "曝光最多" | sort_field + sort_rule | Look up sort mapping | | "longest running" / "投放最久" | sort_field + sort_rule | Look up sort mapping | | "page 2" / "第2页", "next page" / "下一页" | page | Number | | "show more" / "多看一些", "show fewer" / "少看几条" | page_size | Look up page size mapping |

Step 2: Confirm Parameters

Must show parsed parameters before executing the search. Format:

📋 Search Parameters:

🔑 Keyword: puzzle game
🎬 Creative type: Video (010)
🌏 Region: Southeast Asia → TH, VN, ID, MY, PH, SG, MM, KH, LA, BN
📅 Date range: Last 30 days (2026-02-08 ~ 2026-03-10)
📊 Sort: First seen ↓
📄 Per page: 20

Confirm search, or need adjustments?

Rules:

  • List all recognized parameters with both the original value and converted code
  • Show defaults for unspecified parameters
  • For region parameters, show both the region name and actual country codes

Step 3: Ask for Missing Parameters

If the user did not provide a keyword, ask:

What kind of ad creatives are you looking for? You can tell me:
• 🔑 Keyword (e.g. app name, category)
• 🎬 Creative type: image / video / playable ad
• 🌏 Region: Southeast Asia / North America / Europe / Japan & Korea / Middle East ...
• 📅 Time: last week / last month / custom
• 📊 Sort: newest / most popular (impressions)

Other parameters can use defaults, but inform the user in Step 2.

Step 4: Check API Key

Before executing the search, check if $ADCLAW_API_KEY is set (via [ -n "$ADCLAW_API_KEY" ] && echo "configured" || echo "not configured" — never print or output the API Key value).

If not set (empty), output this guidance and stop — do not continue with the search:

🔑 You need to configure an AdClaw API Key before searching.

1. Go to https://adclaw.miaozhisheng.tech to register and get your API Key
2. Run this command to configure:
   openclaw config set skills.entries.adclaw.apiKey "YOUR_API_KEY"
3. Then try your search again 🎉

If set, continue to the next step.

Step 5: Build and Execute curl Command

After user confirmation, build the JSON body and call the API via curl.

Build rules:

  • content_type fixed to "creative"
  • generate_page fixed to true
  • Only include user-specified parameters and non-default values
  • Array parameters use JSON array format: "country_ids":["US","GB"]

Example:

curl -s -X POST "https://ad.h5.miaozhisheng.tech/api/data/search" \
  -H "X-API-Key: $ADCLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_type":"creative","keyword":"puzzle game","creative_team":["010"],"page":1,"page_size":20,"sort_field":"3","sort_rule":"desc","generate_page":true}'

Step 6: Send H5 Result Page Link

The page_url field in the API response is the server-generated H5 page path. Full URL: https://ad.h5.miaozhisheng.tech{page_url}

Send message: Only send the following short message + H5 link. Do NOT append any text-format result list.

🎯 Found XXX ad creatives for "keyword" (page 1)
👉 https://ad.h5.miaozhisheng.tech{page_url}

Say "next page" to continue | Say "video only" to filter

Strict requirement: the message contains only the lines above. Do not output a text list of search results. All results are displayed in the H5 page.

Notes:

  • Pages auto-expire after 24 hours
  • Each search/page turn generates a new page

Step 7: Follow-up Interactions

Possible follow-up commands and how to handle them:

  • "next page" / "下一页": Keep all parameters, page +1, re-execute Step 5-6
  • "video only" / "只看视频": Adjust creative_team, reset page to 1
  • "change keyword to XXX" / "换个关键词": Replace keyword, optionally keep other params
  • Adjust filters: Modify corresponding params, go back to Step 2 to confirm, then re-search

API Response Structure

{
  "totalSize": 1234,
  "page_url": "/p/abc123",
  "page_key": "abc123",
  "list": [{
    "id": "xxx",
    "title": "App Name",
    "describe": "Ad copy...",
    "imageUrl": ["https://..."],
    "videoUrl": ["https://..."],
    "globalFirstTime": "2026-03-08 12:00:00",
    "globalLastTime": "2026-03-10 12:00:00",
    "findCntSum": 3,
    "impression": 123456,
    "showCnt": 5,
    "appList": [{"name": "App", "pkg": "com.xxx", "logo": "https://..."}]
  }]
}

Output Guidelines

  1. Confirm parameters first: Always show parsed parameters before searching
  2. All links in Markdown format: [text](url)
  3. End each output with next-step hints to guide continued interaction
  4. Humanize impression numbers: >10K show as "x.xK", >1M show as "x.xM" (or Chinese equivalents if user speaks Chinese)
  5. Respond in the user's language: Match the language the user is using
  6. Be concise and direct: No small talk, just deliver data
  7. Maintain context: Remember previous parameters when paging or adjusting filters — don't ask from scratch

Related Skills

View on GitHub
GitHub Stars2.1k
CategoryMarketing
Updated3mo ago
Forks325

Languages

Python

Trust signals

98/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info