Duchamp 是针对 Claude Code、Codex 和 Cursor 的广告研究工具。它能找到由策划广告主持续运行 90+ 天的广告，你可以保存、比较并拉取研究材料到你的代理、网页或通过一个远程 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 — ad research for coding agents

Duchamp is an ad-research tool for Claude Code, Codex, and Cursor. It finds the ads curated advertisers have kept running for 90+ days, and you save, compare, and pull the research materials into your agent, on the web or over one remote MCP server: https://duchamp.app/api/mcp.

Call search_ads first, then get_ad or get_brand_anatomy. Creative files, ad copy, keyframes, and transcripts need the signed-in account. Lists and counts on the site are public. A reference prompt from compose_transfer_brief is a reference. It does not promise the same look or the same outcome. The original ad stays a link (duchamp_url). get_ad returns timestamped keyframes, the speech transcript, full body copy, the landing URL, and observed numbers, plus a stored AI analysis when one exists (format, hook, 15 emotional drivers, persona, creative targeting, product category, first product appearance — filled by a nightly batch, Foreplay-style). Treat the analysis as a reference and check it against the materials; search_ads can filter by its fields. Product facts passed to compose_transfer_brief are not stored. Saved items, boards, and watched advertiser pages are stored for the signed-in user. Those tools need a separate per-app opt-in on duchamp.app/saved/connect.

38 tools are registered: 26 ad-research tools, 6 Performance tools, 2 label tools, and 4 marketing workspace tools. The table below is that set.

Performance (your own Meta ad accounts, read only): connect an ad account on duchamp.app/performance, group accounts into workspaces (one per client or brand), then allow the app on duchamp.app/performance/connect. list_workspaces → get_performance_insights with a workspace_id or account_ids (group by ad name, copy, creative, landing page, headline, campaign, ad set, account, workspace or Audience Segment — New Audience, Engaged Audience, Existing Customer, sorted by the workspace’s campaign-name rules or Duchamp’s defaults; by a Meta breakdown at account level — country, age, gender, platform, placement, Meta customer segment; or compare rule groups) → get_performance_timeseries / get_performance_creative / get_performance_ad. Scores (hook, watch, click, convert, viral) are percentiles among every ad (or group) of the workspace in the same period — they are not an industry benchmark. Numbers use the ad set attribution setting and impression-time reporting unless you pick a window with attr_click (1d, 7d, 28d) and attr_view (none, 1d) — Meta no longer returns 7-day or 28-day view. Besides spend, ROAS, CPA, CTR and video rates there are website and Shop purchases, landing page views, add to cart, checkout, leads, drop-off rates and your custom conversions (cc__total, _value, _cost, _roas, listed by get_performance_metrics with a workspace_id).