Duchamp

Duchamp — コーディングエージェント向け広告リサーチ

Duchampは、Claude Code、Codex、Cursor向けの広告リサーチツールです。厳選された広告主が90日以上掲載し続けている広告を見つけ、ウェブ上または1つのリモートMCPサーバー経由で、広告を保存・比較したり、リサーチ資料をエージェントに取り込んだりできます。エンドポイントは https://duchamp.app/api/mcp です。

まずsearch_adsを呼び出し、次にget_adまたはget_brand_anatomyを使います。クリエイティブファイル、広告コピー、キーフレーム、トランスクリプトを利用するには、サインイン済みアカウントが必要です。サイト上のリストと件数は公開されています。compose_transfer_briefの参照プロンプトはあくまで参考資料です。同じ見た目や同じ成果を保証するものではありません。元の広告はリンク（duchamp_url）として残ります。get_adは、タイムスタンプ付きキーフレーム、音声のトランスクリプト、全文の広告コピー、ランディングURL、確認された数値に加え、保存済みのAI分析がある場合はその分析も返します（形式、フック、15種類の感情的動機、ペルソナ、クリエイティブのターゲティング、商品のカテゴリー、商品が初めて登場する箇所。Foreplay風の夜間バッチで入力されます）。分析は参考情報として扱い、資料と照らし合わせて確認してください。search_adsでは、分析項目を使って絞り込めます。compose_transfer_briefに渡した商品情報は保存されません。保存した項目、ボード、ウォッチ中の広告主ページは、サインイン済みユーザー向けに保存されます。これらのツールを使うには、duchamp.app/saved/connectでアプリごとに別途オプトインする必要があります。

登録されているツールは38個です。内訳は、広告リサーチツールが26個、Performanceツールが6個、ラベルツールが2個、マーケティングワークスペースツールが4個です。以下の表に、これらのツールを掲載しています。

Performance（自身のMeta広告アカウント。読み取り専用）：duchamp.app/performanceで広告アカウントを接続し、アカウントをワークスペース（クライアントまたはブランドごとに1つ）にまとめてから、duchamp.app/performance/connectでアプリを許可します。list_workspacesの後に、workspace_idまたはaccount_idsを指定してget_performance_insightsを呼び出します（広告名、コピー、クリエイティブ、ランディングページ、見出し、キャンペーン、広告セット、アカウント、ワークスペース、またはオーディエンスセグメント（新規オーディエンス、エンゲージメント済みオーディエンス、既存顧客）でグループ化し、ワークスペースのキャンペーン名ルールまたはDuchampのデフォルトで並べ替えます。アカウントレベルでMetaの内訳（国、年齢、性別、プラットフォーム、配置、Meta顧客セグメント）を指定することも、ルールグループを比較することもできます）。続けてget_performance_timeseries／get_performance_creative／get_performance_adを使用します。スコア（フック、視聴、クリック、コンバージョン、バイラル）は、同じ期間におけるワークスペース内のすべての広告（またはグループ）を対象としたパーセンタイルであり、業界ベンチマークではありません。数値には広告セットのアトリビューション設定とインプレッション時点のレポートが使われます。attr_click（1日、7日、28日）とattr_view（なし、1日）を指定して期間を選択することもできます。ただしMetaは、7日または28日のビュースルーを返さなくなりました。消化金額、ROAS、CPA、CTR、動画指標に加えて、ウェブサイトとShopでの購入、ランディングページビュー、カートへの追加、チェックアウト、リード、離脱率、カスタムコンバージョン（cc_<id>_total、_value、_cost、_roas。workspace_idを指定してget_performance_metricsで一覧表示）も利用できます。

チームボード（読み取り専用）：scope: "team"または"all"を指定してlist_boardsを呼び出すと、チームのボードも追加されます（scope: "team"と表示）。get_board、export_board、compose_transfer_briefにはboard_scope: "team"を渡し、チームメイトが共有した広告にはscope: "team"を指定してlist_savedを使います。これには、duchamp.app/saved/connectでアプリごとにチームアクセスを別途許可する必要があります。AI共有をオンにしたチームメイトのみが表示され、メモ、保存時のタイトル、リンク項目、コメントは共有されません。

• ウェブサイト：duchamp.app · 英語の概要：duchamp.app/en
• 接続ページ：duchamp.app/mcp
• MCPエンドポイント：https://duchamp.app/api/mcp（Streamable HTTP、無料のDuchampアカウントを使ったOAuth 2.1、APIキー不要）
• AI向け資料：llms.txt · llms-full.txt

利用できる機能

分野	内容	表示
探索	厳選された広告主が90日以上掲載し続けている配信中の広告を毎日収集します（all では、確認されたすべての広告を表示します）。リストと件数は公開されています。	探索
ブランド	1つの広告主の内訳を表示します。競合他社を含め、ページをウォッチできます。自分で追加できるページは最大10件です。	ブランド
比較	公開記録に基づき、最大4つの広告主ページを比較します。インプレッション数と収益は表示されません。	比較
内訳	広告をラベルごとに分類したものです。リサーチの参考資料として利用できます。ラベルにクリエイティブファイルは含まれません。	内訳
保存済みとブリーフ	保存した広告、ラベル、リンクと、参考用プロンプトです。プロンプトは同じ広告が表示されることを保証しません。	保存済み · ブリーフ

数値、日付、価格、レビューを作り出さないでください。文字起こしは音声認識の生データであり、名前を誤って認識している場合があります。エージェントの結論は、人が確認してください。

1行で接続

sh -c "$(curl -fsSL https://duchamp.app/connect.sh)"

スクリプトが Claude Code と Codex を検出してサーバーを登録し、無料の Duchamp アカウントでサインインするためにブラウザーを開きます。コピーするトークンはありません。

手動でのセットアップ

Claude Code

claude mcp add duchamp --scope user --transport http https://duchamp.app/api/mcp

その後、新しいセッションで /mcp を実行し、duchamp を選択して Authenticate を押してください。

Codex

codex mcp add duchamp --url https://duchamp.app/api/mcp
codex mcp login duchamp

Cursor — .cursor/mcp.json に追加し、Cursor の MCP 設定で duchamp の横にある Connect を押してください。

{
  "mcpServers": {
    "duchamp": { "url": "https://duchamp.app/api/mcp" }
  }
}

その他の MCP クライアント — Duchamp という名前のリモートサーバーを追加し、トランスポートに Streamable HTTP、URL に https://duchamp.app/api/mcp を指定してください。初回接続時に OAuth 用のブラウザーが開きます。

プラグインのインストール（スキル＋エージェント）

このプラグインは、MCP サーバーに11個のスキル（有効なものが9個、一時停止中のものが2個）と判定エージェントを追加します。

Claude Code：

/plugin marketplace add duchamp-app/duchamp
/plugin install duchamp@duchamp

Codex：

codex plugin marketplace add duchamp-app/duchamp
codex plugin add duchamp@duchamp

次に、1回サインインしてください：Claude Code では /mcp → duchamp → Authenticate、Codex では codex mcp login duchamp。

• ads-research：配信中の広告を探し、素材とともに広告を1件開き、広告主の内訳を確認し、自分のページを比較して、保存済みライブラリを管理します。使用するスキルはこちらです。
• リサーチ用スキルパック — エージェントが最初から最後まで実行するワークフローです。「use the skill on …」と指示してください。
  • evergreen-hunt：ニッチ分野で90日以上配信された広告をフックごとに分類し、特に有力な広告の文字起こしを表示します。
  • weekly-competitor-sweep：ウォッチ中の広告主について、直近7日間の情報を月曜日の共有用ブリーフにまとめます。
  • creative-test-autopsy：ある広告主が現在テストしている内容と、継続して拡大している内容を明らかにします。
  • board-to-brief：名前付きボードを、保存済み広告に基づく3つの切り口を盛り込んだ制作ブリーフに変換します。
  • hook-mining：ニッチ分野とフォーマットに合わせたフック集を作成し、広告の掲載期間順に並べます。
  • domain-war-room：競合他社のドメインから、その広告、フック、ランディングページ、有料パートナー、攻めの切り口を調べます。
  • angle-theft-detector：パフォーマンス（自社の Meta 広告アカウント）で成果を上げたクリエイティブを、他の広告主の類似広告と照合し、それぞれの切り口の競争の激しさを示します。
• connect-extension：Duchamp Chrome 拡張機能をインストールして接続します（Chrome で Chrome ウェブストアのページが開くので、Add と Connect をクリックしてください）。その後、Meta 広告ライブラリから最初に保存した項目を確認します。
• make と launch-kit：一時停止中です。登録されていないツールを呼び出します。これらのツールは呼び出さないでください。ads-research を使用してください。
• visual-judge エージェント（Claude Code）：新しいコンテキストでレビューを行います。以前このエージェントを呼び出していた make スキルは一時停止中です。

すべての処理は、お使いの Claude Code または Codex のサブスクリプション上で実行されます。

ツール

ツール	機能	1日の上限にカウントされる
search_reference_labels	長期間配信されている広告について、Duchamp が作成した分析（広告主、配信日数、形式、フック、根拠、選定理由、広告ライブラリへのリンク）を検索します。クリエイティブファイルは含まれません。	いいえ
get_reference_label	1件のラベルの全内容を取得します。ビート、レイヤー、応用ルール（差し替える要素、自分で用意する必要がある事実、決して創作してはいけない内容）が含まれます。リサーチ用の参考資料であり、再現を目的としたものではありません。	いいえ
search_ads	観測された広告を検索します。デフォルトでは、配信期間が90日以上のアクティブな広告のみが対象です。all: true を指定すると、観測されたすべての広告が表示されます。配信日数、継続状況、順位（広告主自身の Meta インプレッション順リスト内での位置。広告主間で比較できず、パフォーマンスを示すものではありません）、サインインした状態で表示される広告コピー、Duchamp のミラー上のクリエイティブ URL が含まれます。インライン画像は低解像度のプレビューです。	いいえ
get_ad	観測された1件の広告とリサーチ資料を取得します。事実、履歴、本文全体、ランディング URL、バリエーション、タイムスタンプ付きキーフレーム URL（最大16件）、タイムスタンプ付き音声文字起こし、存在する場合はラベルの概要、同じ広告主のほかの長期間配信広告（最大3件）、Duchamp のミラー上のクリエイティブ URL が含まれます。	いいえ
get_ad_duplicates	1件の広告と同じ画像または動画ファイルを使う、表示可能なすべての広告を取得します。same_creative（すべてのファイルが順序も含めて同一）と same_asset（カルーセルのカード1枚など、少なくとも1つのファイルを共有）が対象です。バイト単位で同一のファイルのみが対象です。search_ads の group_by: "exact_creative" を使うと、クリエイティブごとに1件にまとめられます。	いいえ
search_ad_hooks	フックの一覧です。広告をまたいでグループ化された冒頭の文と、広告の件数、アクティブな広告の件数、配信日数が含まれます。source: "speech" は動画内で話される最初の文（それが始まる2文目とともに）、source: "copy" は広告本文の最初の行です。広告主ページ、ニッチ、テキストで絞り込めます。	いいえ
get_brand_anatomy	1つの広告主ページについて、広告の構成、長期間配信されている広告、インプレッション順リスト内での順位、フック、ランディングページ、CTA を取得します。	いいえ
compare_brands	最大4つの広告主ページを並べて比較します。インプレッション数と売上は含まれません。	いいえ
get_connection_status	新しいセッションでは最初に呼び出してください。サインイン状態と、このアプリが保存済みライブラリおよびマーケティングワークスペースを利用できるかを確認します。許可するページと次の手順も表示されます。	いいえ
get_extension_status	このユーザーの Duchamp Chrome 拡張機能の接続状態（カウント、バージョン、最終使用日時）と接続方法を確認します。インストールを案内する間、ポーリングしてください。	いいえ
get_brand_landings	1つの広告主について、観測された広告をランディングページ別にグループ化して取得します（トラッキングパラメーターは削除され、商品 ID とアプリ ID は保持されます）。広告数とアクティブな広告数が含まれます。	いいえ
get_brand_partners	1つの広告主の観測広告で Meta が有料パートナー（「Paid partnership with …」）として表示するページを取得します。広告数、アクティブな広告数、初回および最終確認日、Meta 広告ライブラリへのリンクが含まれます。また、このページをパートナーとして表示する、ほかの追跡対象広告主と、パートナーシップ広告（最大24件）も取得します（ads：パートナーページ、配信日数、形式、タイトル、Duchamp リンク。配信中の広告が先に表示され、その後は配信期間の長い順で表示されます。パフォーマンスの順位ではありません）。クリエイター名と契約条件はデータに含まれません。	いいえ
get_creative_velocity	1つの広告主について、7日、14日、30日、または60日間の1日ごとの配信開始、配信終了、アクティブな広告の数（純増減、ピーク日、1日あたりの平均）と、配信された広告のタイムラインを取得します。同じクリエイティブを任意でグループ化できます。また、クリエイティブテスト（過去60日間に同じ日に開始された広告が2件以上ある場合の、現在も配信中の件数 N/M と、最も長く配信された広告。順位ではなく配信日数を示します）や、前週との変化を示す日次シグナルも含まれます（日次シグナルは、現在90日以上配信中の広告と、過去14日間に開始された広告のうちバリエーションが3件以上追加されたクリエイティブを示します。広告主が複数のバージョンを有効にしたことを示すもので、リーチの増加を示すものではありません）。Duchamp がそのページを初めて観測する前の日数は、下限値です。	いいえ
find_advertisers_by_domain	広告から特定のドメインまたは URL（サブドメインを含む）へ誘導する、追跡対象の広告主ページを検索します。ドメインが一致しても、所有権の証明にはなりません。	いいえ
get_collection_status	追跡対象ページごとの観測の鮮度と範囲（最終確認日、観測日数、順位付けされた日数、最終試行日時）と、7日間に収集されたページ数を確認します。順位の変化を信頼する前に確認してください。	いいえ
list_watched_brands	このユーザーがウォッチしている広告主ページを一覧表示します。ユーザー自身のページとしてマークされたものも含まれます。	いいえ
list_saved	このユーザーが保存した広告、ラベル、https URL を一覧表示します。それぞれのメモ、タグ、評価も含まれます。tag または min_rating で絞り込めます。scope: "team" を指定すると、チームメンバーが共有した広告とラベルをページ分割して一覧表示します。	いいえ
list_boards	このユーザーのボードを一覧表示します。scope: "team"／"all" を指定すると、チームのボードも追加されます。	いいえ
get_board	1つのボードを取得します。広告アイテムには、観測番号、サインインした状態で表示される広告コピー、Duchamp のミラー上のクリエイティブ URL が含まれます。ラベルアイテムには概要が含まれますが、クリエイティブファイルは含まれません。	いいえ
watch_brand	広告主ページをウォッチします（ページ ID または広告主ページの URL）。is_mine はユーザー自身のページを示します。	いいえ
unwatch_brand	広告主ページのウォッチを解除します。	いいえ
save_to_library	広告、参照ラベル、または https URL を保存します。任意でメモ、タグ、1～5つ星の評価を付けられます。メモとタグは呼び出しログに記録されません。	いいえ
create_board	ボードを作成します。	いいえ
add_to_board	保存済みアイテムの ID をボードに追加します。	いいえ
update_saved	保存済みアイテム1件のタイトル、メモ、タグ（すべて置き換え）、または1～5つ星の評価（null でクリア）を変更します。duchamp.app の保存済みカードと同じ項目を変更できます。	いいえ
remove_from_board	保存済みアイテムの ID をボードから削除します。アイテムはライブラリに残ります。	いいえ
export_board	1つのボードを JSON（デフォルト）または CSV でエクスポートします。メモ、タグ、評価、観測番号、サインインした状態で表示される広告コピー、リンクを含む、アイテムごとの行が出力されます。クリエイティブファイルの URL は含まれません。スプレッドシートの数式として実行される可能性がある CSV のセルには、先頭に ' が付けられます。サインイン済みのダウンロードリンクも提供されます。	いいえ
compose_transfer_brief	広告、ラベル、ページ、またはボードを参考にし、ユーザー自身のコンテキストにある事実を加えて、参照用プロンプトを作成します。あくまで参考であり、再現を保証するものではありません。これらの事実は保存もログへの記録もされません。	いいえ
list_workspaces	ユーザーのワークスペース（クライアントまたはブランドごとにまとめた広告アカウント）と、有効な広告アカウント（通貨、タイムゾーン、同期済みの対象範囲）、未割り当てアカウント、保存済みレポートを一覧表示します。Performance 接続ページで別途オプトインする必要があります。	いいえ
get_performance_metrics	すべての Performance 指標 ID、計算式、単位、スコアルール、グループ化のディメンション、アトリビューション期間を取得します。workspace_id または account_ids を指定した場合は、その対象範囲のカスタムコンバージョンも含まれます。	いいえ
get_performance_insights	選択したアトリビューション期間について、指標、スコア、純結果を含む Top Performing（Meta の内訳を含む、1つのディメンションでグループ化）または Comparison（ルールグループ）レポートを取得します。さらに、クリエイティブテストの対象数として、New Launched、Scaling、Winners、Losers をワークスペース独自のしきい値（Creative Tests ページで設定）と比較し、新しいクリエイティブと前の期間も表示します。preset を指定すると、5種類のサンプルレポート（前の期間からの CPC と ROAS の変化を示す creative_fatigue、landing_pages、広告名のトークンに基づく product_comparison、image_vs_video、video_analysis）のいずれかが開きます。プリセットはグループ化と並べ替えを行うもので、結論を示すものではありません。	いいえ
get_performance_timeseries	選択したアトリビューション期間について、ワークスペース、アカウント、または1つのレポート行（内訳の値を1つ含む）の日次、週次、月次の値を取得します。	いいえ
get_performance_creative	1つのクリエイティブグループを取得します。指標、スコア、そのクリエイティブを使用する広告と広告コピー、アセットが含まれます。	いいえ
get_performance_ad	1つの広告を取得します。アセット、すべての指標とスコア、日次推移が含まれます。	いいえ
list_marketing_projects	ユーザーのマーケティングプロジェクトを一覧表示します。Marketing 接続ページで別途オプトインする必要があります。	いいえ
get_marketing_project	1つのマーケティングプロジェクトを読み込みます。	いいえ
create_marketing_project	マーケティングプロジェクトを作成します。	いいえ
update_marketing_project	マーケティングプロジェクトを更新します。先に最新バージョンを読み込んでください。	いいえ
広告リサーチツールには、1日あたりの取得件数制限はありません。表には38個のツールがあります。

プロンプトの例

最初に使うプロンプト（［ ］の部分を置き換えてください）：

• ブランドの概要 — 「Duchamp MCP を使って、［広告主名またはホームページ］を調べてください（ホームページの場合は find_advertisers_by_domain、名前の場合は search_ads の facets.pages を使います）。search_ads（page_id、status active、sort recent、all true）を使って、配信中の最新広告を6件表示し、それぞれの duchamp_url にリンクしてください。続けて、フォーマット、オファー、最もよく使われている切り口を箇条書きで3つ挙げてください。」
• UGC スクリプトの書き換え — 「［ニッチ］の配信中の自撮り風動画広告を search_ads で検索し、最も長く掲載されている広告を選んでください。get_ad で文字起こしを取得し、［自社製品］向けの30秒スクリプトに書き換えてください。構成は維持し、言葉を変えてください。」
• オファーの調査 — 「［ニッチ］の配信中広告を search_ads で検索し、すべてのオファー（割引、セット販売、送料無料、保証、お試し）を、登場頻度の高い順に一覧にしてください。上位3件には、それぞれ広告を1つずつ添えてください。」
• フォーマット構成の確認 — 「search_ads を使って、［ニッチ］の配信中広告を媒体（動画、画像、カルーセル）別に数えてください。それぞれの媒体で最も長く掲載されている広告と、あまり使われていないフォーマットを示してください。」
• 広告コピーの参考例 — 「search_ads で［ニッチ］の90日以上掲載されている画像広告を10件見つけてください。get_ad でコピーを取得し、その中から優れた5件を［自社製品］向けに書き換えてください。」

その他：

• 「search_ads で自分のニッチの長期掲載広告を見つけてください。広告主、掲載日数、duchamp_url を一覧にしてください。インプレッション数や収益を作り上げないでください。」
• 「get_ad でこの広告を開き、次にその広告主の get_brand_anatomy を取得してください。キーフレームと文字起こしを確認し、フックとオファーを教えてください。duchamp_url にリンクしてください。」
• 「watch_brand を is_mine true で使って自分のページをウォッチし、競合他社もウォッチしてから、compare_brands を実行してください。ページは最大4件までです。」

仕組み

1. get_connection_status で接続を確認します。保存済みライブラリをこのアプリで利用できない場合は、保存する前に、返されたリンクを開いてください。
2. search_ads で検索します。
3. get_ad で広告を1件開くか、get_brand_anatomy で広告主を1社開きます。
4. 最大4件の page id を指定して compare_brands で比較するか、保存済みライブラリへのオプトイン後にライブラリツールで保存します。
5. ユーザーから依頼があった場合は、compose_transfer_brief で引き継ぎます。これは参照用のプロンプトです。同じ広告が見つかることを保証するものではありません。

制限とアカウント

• 初回接続時に、無料の Duchamp アカウントにサインインします（ブラウザーで OAuth）。API キーは不要です。
• 広告リサーチツールは1日あたりの制限にカウントされません。
• Pro は月額 $19 または年額 $190 で掲載されています（自分で収集した競合ページを毎日5件、MCP は無制限）。支払いが開始されると、Free では検索が無制限となり、MCP 経由で1日10件の広告を開けます。支払いはまだ開始されていないため、現在はすべて無料で、制限もありません。duchamp.app/en/pricing をご覧ください。
• アイテムは公開日に表示されます。サイトに掲載されていない ID は利用できません。

プライバシー

Duchamp は、アカウント、利用記録、保存したアイテム、ボード、閲覧した広告主のページを保存します。広告アカウントを Performance に接続すると、Duchamp はそのアカウントの広告メタデータと日次のパフォーマンス数値（および暗号化された読み取り専用アクセストークン）を、お客様のアカウント専用に保存します。公開ライブラリやチームに保存されることはありません。また、アカウントをオフにするか、接続を解除するか、Facebook の設定でアプリを削除すると、これらのデータは削除されます。パフォーマンス数値が AI アプリに送信されるのは、Performance の接続ページでそのアプリを許可した後のみです。compose_transfer_brief に渡された製品情報は保存されません。レンダリングされたファイルはお使いのマシンに保存されたままです。Duchamp はリクエストに対してモデルを呼び出しません。音声の文字起こしは、動画の収集時に動画ごとに一度だけ行われます。Duchamp は広告を複製しません。サインイン済みの広告リサーチでは、Duchamp のミラー上のクリエイティブ URL が含まれることがあります。参照ラベルにクリエイティブファイルは含まれません。

Duchamp が行わないこと：

• 人間の顔、人物の肖像、顔の差し替え、ディープフェイク、合成音声の生成は行いません。Duchamp は実在する人物の合成メディアを作成しません。
• 音声のクローン作成、音声や音楽の生成、成人向けコンテンツ、AI コンパニオンや恋愛関係に関する機能はありません。
• テンプレート：他人の投稿やアカウントの表示や再ホストは行いません。テンプレートに元の文言、画像、アカウント名は含まれません。
• 広告リサーチ：サインイン済みの呼び出し元には、Duchamp のミラー上のクリエイティブ URL が提供されます。ツールの結果に含まれるインライン画像は、エージェント向けの低解像度プレビューです。ユーザーに表示する際は、duchamp_url にリンクしてください。参照ラベルにクリエイティブファイルは含まれません。Duchamp は広告を複製しません。
• スケジュール設定や公開は行いません。Performance は、パフォーマンスレポート用に、お客様自身が接続した広告アカウント（Meta、読み取り専用、ads_read）のみを読み取ります。サーバー側でのコンテンツ生成は行いません。エンゲージメントの自動化は行わず、ユーザーが所有していないアカウントにもアクセスしません。
• 個人データの集約や転売、パフォーマンスの保証は行いません。

元の投稿に関する権利は、それぞれの権利者に帰属します。テンプレートの削除を希望する場合は、元の URL を添えて [email protected] までご連絡ください。

リンク

• duchamp.app · 英語の概要 · 接続 · 料金
• llms.txt · llms-full.txt
• 会社：Notique（ソウル） · お問い合わせ：[email protected]

ライセンス

MIT。詳しくはLICENSEをご覧ください。