mcpField
A
admapix

admapix

github.com/fly0pantsマーケティング・グロース694 回インストール10 週間前に更新
リポジトリ

admapix について

admapixは、AdMapixから競合広告クリエイティブの生データを取得するスキルです。キーワードや条件でレコードを検索し、構造化JSONを返します。要約や分析、表示用コンテンツの作成は対象外です。

主な機能

  1. 01競合広告クリエイティブの検索
  2. 02キーワードや条件による絞り込み
  3. 03生データを構造化JSONで返却
  4. 04admapix.search_creatives MCPツールを優先

活用シーン

  1. 01アプリや広告主のクリエイティブ検索
  2. 02国、種類、日付によるレコードの絞り込み
  3. 03広告文やメディアリンク項目の取得

MCP 対応

利用可能な場合はadmapix.search_creatives MCPツールを優先し、利用できない場合はAdMapix APIを直接呼び出します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fly0pants/admapix --skill admapix

インストール後、Claude Code で/admapixを入力して読み込まれたか確認します。

同梱ファイルreferences/param-mappings.md

詳細

AdMapix 生データ検索

AdMapix から競合他社の広告クリエイティブの生データを取得するには、このスキルを使用します。

API から構造化データを返します。プレゼンテーション、メッセージ送信、自律的な調査、要約、インサイト、推奨、ダッシュボードの各ワークフローは対象外です。

データソース

利用可能な場合は、admapix.search_creatives MCP ツールを優先してください。MCP ツールが利用できない場合は、API を直接呼び出します。

curl -s -X POST "https://api.admapix.com/api/data/search" \
  -H "X-API-Key: $ADMAPIX_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"}'

API キーを表示または公開しないでください。

リクエストパラメーター

パラメーター型デフォルト説明
keywordstring""検索キーワード：アプリ名、広告コピー、広告主、製品、またはカテゴリ
creative_teamstring[]omitクリエイティブの種類コード。例：動画の場合は ["010"]
country_idsstring[]omit国コード。例：["US","JP"]
start_datestringAPI default開始日。YYYY-MM-DD
end_datestringAPI default終了日。YYYY-MM-DD
sort_fieldstring"3""3" 初回掲載日、"4" 掲載日数、"11" 関連度、"15" インプレッション数
sort_rulestring"desc""desc" または "asc"
pageint1ページ番号。1 から開始
page_sizeint201 ページあたりの結果数。1～60
trade_level1string[]omit業種カテゴリ ID
content_typestring"creative"固定のリクエスト値

リクエスト本文にプレゼンテーション生成やメッセージ送信用のフィールドを追加しないでください。

パラメーターの解析

ユーザーが指定したすべてのパラメーターを抽出します。自然言語からのマッピングが必要な場合は、次の項目について references/param-mappings.md を参照してください。

  • クリエイティブの種類：動画／画像／プレイアブル、视频／图片／试玩
  • 地域または国：東南アジア、米国、日韓、ヨーロッパ
  • 相対的な日付範囲：先週、最近一週間、先月
  • 並べ替え：新着順、インプレッション数の多い順、掲載期間の長い順
  • ページサイズとページネーション

ユーザーがキーワードまたは同等の検索対象を指定していない場合は、キーワードを簡潔に尋ねてください。それ以外のパラメーターにはデフォルト値を使用できます。

出力ルール

構造化された JSON のみを返します。可能な限り API のフィールド名を維持してください。

呼び出し成功後の必須レスポンス形式：

{
  "request": {
    "content_type": "creative",
    "keyword": "puzzle game",
    "page": 1,
    "page_size": 20,
    "sort_field": "3",
    "sort_rule": "desc"
  },
  "totalSize": 1234,
  "page": 1,
  "page_size": 20,
  "list": []
}

エラーの場合は、構造化された JSON を返します。

{
  "error": {
    "code": "missing_api_key",
    "message": "Missing ADMAPIX_API_KEY environment variable",
    "retry": false
  }
}

次のことをしないでください。

  • 外部のプレゼンテーション用リンクの背後にレコードを隠す
  • リンクの背後にレコードを隠す
  • 結果一覧を要約する
  • ユーザーがデータを受け取った後に別途分析を求めない限り、順位付け、分析、戦略の推奨を行う
  • 複数ステップの自律的なワークフローや外部検索を実行する
  • ランディングページ、カード、表を中心としたドキュメント、またはダッシュボードの形式で回答する

生のレスポンスフィールド

list の各項目には、次のような上流フィールドが含まれる場合があります。

{
  "id": "creative-id",
  "title": "App or advertiser name",
  "describe": "Ad copy",
  "imageUrl": ["https://..."],
  "videoUrl": ["https://..."],
  "playHtmlUrl": ["https://..."],
  "globalFirstTime": "2026-03-08 12:00:00",
  "globalLastTime": "2026-03-10 12:00:00",
  "findCntSum": 3,
  "impression": 123456,
  "showCnt": 5,
  "adSource": "network",
  "appList": [
    {"name": "App", "pkg": "com.example.app", "logo": "https://..."}
  ]
}

コメント

Markdown 対応