AdMapix

**Summary:** Major refactor to make the skill a pure data-layer provider for AdMapix API, removing analysis, summaries, and autonomous workflows. - Now returns only raw structured JSON from AdMapix API endpoints; all analysis and composition moved to the calling agent. - Removed generation of HTML/H5 pages, hosted research, summaries, rankings, and dashboards. - Updated instructions and endpoint catalog; clarified parameter mapping workflows and output rules. - Simplified authentication flow and setup guidance, with clear language adaptation. - Documented strict pass-through of API fields—no renaming, summarizing, or hiding data. - Explicitly marked download/revenue figures as third-party estimates for agent-side handling.

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.

admapix 1.0.28 - Updated description: now includes a direct link (https://www.admapix.com) for users to obtain an API key. - Improved onboarding clarity by instructing users to sign up and get their API key at AdMapix before use. - No logic or workflow changes; all interaction flows, API handling, and language rules remain the same.

No user-facing changes in this version; no file modifications detected.

admapix v1.0.26 - Added a new step to the Deep Research ("Deep path") workflow: now validates the user's API key via quota endpoint before submitting tasks, preventing wasted resources on invalid/disabled keys. - Updated error handling: if API key is invalid or account is disabled, the user receives a clear message and the process stops immediately. - Deep Research process is now a 4-step workflow (was 3 steps) to improve reliability and user guidance. - No changes to file structure; SKILL.md updated for process and instruction clarity.

admapix 1.0.25 Changelog - Updated API key setup flow: now instructs users to return with their key instead of auto-configuring on paste; disables the previous "auto-configure" workflow. - Clarified language-specific instructions for API key setup, with more explicit step-by-step guides for both Chinese and English users. - Improved handling of users pasting API keys directly by auto-detecting and configuring without extra confirmation. - No code or functional logic changes beyond onboarding and key setup guidance.

admapix 1.0.24 - Fully revamped API key setup flow: users now paste their AdMapix API key and configuration is handled automatically, removing the need for manual CLI commands. - Improved onboarding: clearer, step-by-step guidance for both Chinese and English users, including registration and API key generation. - Outdated instructions to run `openclaw config set` removed; users simply send their API key directly. - Language-matched instructions and confirmation when API key is configured. - All other features and usage patterns remain unchanged.

Use deepresearch.admapix.com domain instead of raw IP for deep research framework

Remove deep research framework (external IP references)

No code or logic changes in this version. - No file changes detected; documentation and instructions remain unchanged. - All features, interaction flow, and API usage are the same as the previous version.

admapix 1.0.0 – Initial Release - Launches an ad intelligence & app analytics assistant powered by api.admapix.com. - Supports search of ad creatives, app analysis, rankings, downloads, revenue, and market insights in English and Chinese. - Switches response language and data formatting based on user’s language. - Implements query complexity classification: simple queries handled directly, deep/multi-step queries routed to a research framework for comprehensive reports. - Clear API key checking process with user guidance if missing. - Automatic handling of third-party data disclaimers and user-facing error messages, all localized.

**Summary:** Adds query complexity classification and fully integrates the Deep Research Framework for multi-step, analytical, or cross-entity research. - Introduces automatic complexity detection to route queries as Simple (single API call) or Deep (multi-step, analysis, or comparison). - Deep queries are handled via a dedicated external research framework, with automated task creation, polling, and summary/report delivery. - For Simple queries, suggests deep research as a follow-up ("Want deeper analysis? Try..."). - Ensures critical external framework call and polling steps are followed exactly for Deep Research tasks. - Enhanced hinting and clearer execution distinction for user workflows.

**Major upgrade: Expands from ad creative search to full ad/app intelligence and market analytics!** - Added five new reference files to enable: app/product analytics, rankings, downloads/revenue trends, ad distribution, and market analysis. - Greatly broadened intent detection — now supports queries on rankings, downloads, revenue, market share, competitor analysis, and more. - Output always matches detected user language (Chinese/English), including all summaries, disclaimers, and number formats. - New step-by-step orchestration: routes each query by intent, loads only relevant API docs, runs multi-step "deep dive" analyses autonomously. - All download/revenue data now include clear third-party data disclaimers. - Maintains previous creative search workflow, but extends to browse, analyze, compare, and deep-dive modes for richer insights. - Strict, streamlined API key check at start of every session.

**API endpoint and branding update** - Switched all API and H5 result endpoints from `ad.h5.miaozhisheng.tech` to `api.admapix.com` - Updated API registration/config guidance and links to new `admapix.com` addresses - Revised all in-skill example requests, responses, and result message templates to use the new domain - No functional/logic changes beyond API/branding updates

admapix 1.0.12 - Added: README_CN.md for Chinese documentation - Updated: SKILL.md major rewrite for full bilingual (Chinese/English) support - Now auto-detects user language and replies accordingly - Instructions and parameter mappings clarified, supporting both English and Chinese keywords and commands - Interaction/process guidance now available in both languages for better accessibility and international usability

admapix v1.0.8 - 强化了 API Key 检查环节，要求通过 shell 判定配置状态，严禁输出或打印 API Key 内容 - 其它功能与流程保持不变

admapix 1.0.8 - 优化 API Key 检查方式，避免输出明文 API Key，仅显示配置状态 - 增强安全性，API Key 检查由 echo 改为 `[ -n "$ADMAPIX_API_KEY" ] && echo "已配置" || echo "未配置"` - 其他交互及流程保持不变

AdMapix v1.0.7 introduces API Key检查功能： - 新增第4步，搜索前自动检测环境变量 ADMAPIX_API_KEY 是否已设置 - 未配置API Key时，会引导用户如何获取与设置API Key，并终止搜索流程 - metadata环境变量名称从 API_KEY 改为 ADMAPIX_API_KEY - 文档及curl示例同步更新为 ADMAPIX_API_KEY - 其余逻辑流程保持不变

- 更改 AdMapix API 请求和页面访问协议，从 HTTP 升级为 HTTPS，接口地址由 http://ad.h5.miaozhisheng.tech 改为 https://ad.h5.miaozhisheng.tech - 更新所有相关 API 示例命令和结果页 URL，用 https:// 前缀替换原本的 http:// - 其他交互流程、参数映射及输出规范保持不变

**切换为直连 AdMapix API，流程更简化** - 数据获取方式由本地 mcporter CLI 切换为直接用 curl 请求 AdMapix API，不再依赖本地工具或服务端配置。 - 精简依赖：仅需 API_KEY 环境变量，移除了 mcporter 和 admapix-mcp 等组件。 - 构建请求格式调整为标准 JSON，所有交互通过 HTTP POST 实现。 - 返回参数格式（如 page_url）及消息模板轻微变化，H5 搜索页链接格式更新。 - 文档大幅精简，删除所有 CLI/Shell 配置步骤，聚焦 curl/API 使用说明和标准交互流程。