Duchamp

Duchamp — 面向编码 Agent 的广告研究

Duchamp 是一款面向 Claude Code、Codex 和 Cursor 的广告研究工具。它可以找到精选广告主已连续投放 90 天以上的广告，让你保存、比较这些广告，并在网页上或通过一个远程 MCP 服务将研究材料导入 Agent：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 个广告研究工具、6 个 Performance 工具、2 个标签工具和 4 个营销工作区工具。下表列出了这些工具。

Performance（仅可读取你自己的 Meta 广告账户）：在 duchamp.app/performance 连接广告账户，将账户分组到工作区中（每个客户或品牌一个工作区），然后在 duchamp.app/performance/connect 允许应用访问。list_workspaces → 使用 workspace_id 或 account_ids 调用 get_performance_insights（按广告名称、文案、创意、落地页、标题、广告系列、广告组、账户、工作区或 Audience Segment 分组——包括 New Audience、Engaged Audience、Existing Customer；按工作区的广告系列名称规则或 Duchamp 的默认规则排序；按账户级别的 Meta 细分维度分组——国家/地区、年龄、性别、平台、版位、Meta 客户细分；或比较规则组）→ get_performance_timeseries / get_performance_creative / get_performance_ad。评分（钩子、观看、点击、转化、传播）是同一时间段内该工作区所有广告（或分组）的百分位数，并非行业基准。数据采用广告组的归因设置和展示时间报告方式；也可以选择包含 attr_click（1d、7d、28d）和 attr_view（none、1d）的窗口——Meta 已不再返回 7 天或 28 天的浏览归因数据。除支出、ROAS、CPA、CTR 和视频指标外，还包括网站和 Shop 购买、落地页浏览、加入购物车、结账、潜在客户、流失率以及自定义转化（cc_<id>_total、_value、_cost、_roas；可通过 get_performance_metrics 并传入 workspace_id 查看）。

团队看板（只读）：调用 list_boards 并设置 scope: "team" 或 "all"，即可添加团队看板（标记为 scope: "team"）；调用 get_board、export_board 和 compose_transfer_brief 时传入 board_scope: "team"；调用 list_saved 并设置 scope: "team"，即可查看队友共享的广告。使用此功能需要在 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 会显示所有观察到的广告）。列表和数量均公开。	探索
品牌	单个广告主的细分情况。关注一个主页，也可以关注竞争对手。你自行添加的主页数量上限为 10 个。	品牌
比较	最多比较四个来自公开记录的广告主页。不提供展示次数和收入数据。	比较
细分分析	按标签拆解广告，供研究参考。标签不包含创意文件。	细分分析
已保存内容和简报	已保存的广告、标签和链接，以及参考提示词。提示词不保证找到相同的广告。	已保存 · 简报

请勿编造数字、日期、价格或评论。转录文本是未经处理的语音转文字，可能会误听名称。应由人工检查 Agent 得出的结论。

一行连接

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 授权。

插件安装（技能 + Agent）

此插件在 MCP 服务的基础上增加了十一项技能（九项启用、两项暂停）和一个评审 Agent。

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

然后登录一次：Claude Code 执行 /mcp → duchamp → Authenticate；Codex 执行 codex mcp login duchamp。

• ads-research：查找有效广告、打开一条广告及其素材、拆解广告主、比较你的主页，并维护已保存的广告库。这是应使用的技能。
• 研究技能包 — Agent 端到端运行的工作流。使用时说“对……使用 技能”：
  • evergreen-hunt：寻找某个细分领域中投放 90 天以上的广告，按开场钩子分类，并为表现最好的广告提供转录文本。
  • weekly-competitor-sweep：将你关注的广告主过去 7 天的动态整理成适合发到 Slack 的周一简报。
  • creative-test-autopsy：分析某个广告主当前正在测试什么，以及持续加大投放的内容。
  • board-to-brief：将一个命名看板转化为制作简报，包含三个基于已保存广告的角度。
  • hook-mining：为某个细分领域和格式建立开场钩子库，并按广告投放时长排序。
  • domain-war-room：根据竞争对手的域名，查找其广告、开场钩子、落地页、付费合作伙伴和竞争策略。
  • angle-theft-detector：将你在 Performance 中的获胜创意（来自你自己的 Meta 广告账号）与其他广告主的相似广告匹配，并显示每个创意角度的竞争拥挤程度。
• connect-extension：安装并连接 Duchamp Chrome 扩展程序（会在 Chrome 中打开 Chrome 网上应用店页面，你需要点击 Add 和 Connect），然后确认首次从 Meta 广告资料库保存内容。
• make 和 launch-kit：已暂停。这些技能会调用未注册的工具。请勿调用这些工具。请使用 ads-research。
• visual-judge Agent（Claude Code）：在全新上下文中进行评审。过去会调用它的 make 技能现已暂停。

所有功能均通过你自己的 Claude Code 或 Codex 订阅运行。

工具

工具	功能	是否计入每日限额
search_reference_labels	搜索 Duchamp 对长期投放广告的文字拆解（广告主、投放天数、格式、钩子、证据、入选原因、广告资料库链接）。不含创意文件。	否
get_reference_label	获取一条完整标签：节拍、层次和迁移规则（要替换什么、哪些内容需要使用你自己的事实、哪些内容绝不能编造）。这是研究参考，不是复刻。	否
search_ads	搜索已观察到的广告。默认仅显示活跃且已投放 90 天以上的广告；all: true 会显示所有已观察到的广告。包括投放天数、存续情况、排名（广告主自己的 Meta 展示次数排序列表中的位置——不同广告主之间不可比较，也不代表表现）、登录后可见的广告文案，以及 Duchamp 镜像中的创意 URL。内嵌图片为低分辨率预览。	否
get_ad	获取一条已观察到的广告及研究资料：事实、历史、完整正文文案、落地页 URL、变体、带时间戳的关键帧 URL（最多 16 个）、带时间戳的语音转录文本（如果有标签，则附标签摘要）、同一广告主的最多三条其他长期投放广告，以及 Duchamp 镜像中的创意 URL。	否
get_ad_duplicates	获取所有使用与某条广告相同图片或视频文件的可见广告：same_creative（所有文件完全相同且顺序一致）和 same_asset（至少共享一个文件，例如同一轮播卡片）。仅包含字节完全相同的文件。使用 search_ads 的 group_by: "exact_creative"，可将它们合并为每种创意一个条目。	否
search_ad_hooks	钩子库：按广告开场白分组，并显示不同广告数、活跃广告数和投放天数。source: "speech" 表示视频中说出的第一句话（以及它开始时的第二句话），source: "copy" 表示广告正文的第一行。可按广告主主页、细分领域或文本筛选。	否
get_brand_anatomy	获取一个广告主主页的信息：广告组合、长期投放广告、其自身展示次数排序列表中的位置、钩子、落地页和 CTA。	否
compare_brands	并排比较最多四个广告主主页。不提供展示次数或收入。	否
get_connection_status	在新会话中先调用。确认登录状态，以及此应用是否可以使用已保存的资料库和营销工作区，并提供授权页面和后续步骤。	否
get_extension_status	查看此用户的 Duchamp Chrome 扩展是否已连接（数量、版本、最后使用时间），以及如何连接。指导安装时可轮询此工具。	否
get_brand_landings	获取一个广告主已观察到的广告，按落地页分组（移除跟踪参数，保留产品和应用 ID），并显示广告数和活跃广告数。	否
get_brand_partners	获取 Meta 在一个广告主已观察到的广告中显示为付费合作伙伴（“Paid partnership with …”）的主页，并显示广告数、活跃广告数、首次和最后出现日期，以及 Meta 广告资料库链接；还包括其他显示此主页为合作伙伴的已跟踪广告主，以及最多 24 条合作广告（ads：合作伙伴主页、投放天数、格式、标题、Duchamp 链接；先列出仍在投放的广告，再按投放时长排序，不代表表现排名）。数据中不包含创作者姓名和交易条款。	否
get_creative_velocity	获取一个广告主在过去 7、14、30 或 60 天内每天新投放、停投和活跃广告的数量（净变化、峰值日、日均值），以及已投放广告的时间线（可选择按相同创意分组）；还包括创意测试（过去 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	获取一个看板。广告条目包括观察编号、登录后可见的文案，以及 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–5 星评分（null 会清除评分）——这些字段与 duchamp.app 上已保存卡片的字段相同。	否
remove_from_board	从看板中移除已保存项目的 ID。项目仍保留在资料库中。	否
export_board	将一个看板导出为 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 细分项）或 Comparison（规则组）报告，包含指标、评分和净结果；还包括创意测试目标：New Launched、Scaling、Winners 和 Losers 的数量及其相对于工作区自身阈值的表现（在 Creative Tests 页面设置）、新创意和上一周期数据。preset 可打开五种示例报告（creative_fatigue，包含 CPC 和 ROAS 相较上一周期的变化；landing_pages、product_comparison，根据广告名称中的词元分类；image_vs_video、video_analysis）——预设的分组和排序并不代表结论。	否
get_performance_timeseries	获取所选归因时间窗下，工作区、账户或单条报告行（包括某个细分值）的每日、每周或每月数据。	否
get_performance_creative	获取一个创意组：指标、评分，以及使用该创意组的广告及其文案和素材。	否
get_performance_ad	获取一条广告：素材、所有指标和评分、每日趋势。	否
list_marketing_projects	列出用户的营销项目。需要在营销连接页面单独选择启用。	否
get_marketing_project	查看一个营销项目。	否
create_marketing_project	创建营销项目。	否
update_marketing_project	更新营销项目。请先读取最新版本。	否
广告研究工具不计入每日调用额度。表格中共有 38 个工具。

示例提示词

起始提示词（替换 [ ] 部分）：

• 品牌概览 — “使用 Duchamp MCP，查询 [广告主名称或主页]（主页使用 find_advertisers_by_domain，名称使用 search_ads 的 facets.pages）。使用 search_ads 展示最新的 6 条投放中广告（page_id、status active、sort recent、all true），并为每条广告添加 duchamp_url 链接。然后用 3 条要点总结：广告形式、优惠，以及最常见的宣传角度。”
• UGC 脚本改写 — “使用 search_ads 搜索 [细分领域] 中仍在投放的自拍视频广告，选出投放时间最长的一条，用 get_ad 获取其转录文本，并将其改写为适用于 [你的产品] 的 30 秒脚本。保留结构，替换文字。”
• 优惠扫描 — “使用 search_ads 搜索 [细分领域] 中仍在投放的广告，并列出所有优惠（折扣、套装、免运费、保证、试用），按出现频率排序，每个排名前 3 的优惠各附一条广告。”
• 广告形式组合检查 — “使用 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。最多比较四个主页。”

工作原理

1. 使用 get_connection_status 检查连接。如果此应用不允许使用已保存的资料库，请先打开它返回的链接，然后再保存。
2. 使用 search_ads 搜索。
3. 使用 get_ad 打开一条广告，或使用 get_brand_anatomy 打开一个广告主。
4. 使用 compare_brands 比较（最多四个 page id），或在选择加入已保存资料库后使用资料库工具保存。
5. 用户提出请求时，使用 compose_transfer_brief 移交。它是一条参考提示词，不保证能找到同一条广告。

限制与账户

• 首次连接时，使用免费的 Duchamp 账户登录（在浏览器中通过 OAuth 登录）。无需 API 密钥。
• 广告研究工具不计入每日限额。
• Pro 标价为每月 $19 或每年 $190（每天可收集自己的 5 个竞争对手主页，无限使用 MCP）。开放付款后，Free 将继续提供无限搜索，并允许每天通过 MCP 打开 10 条广告。目前尚未开放付款，因此现在所有功能均免费且不限量。请参阅 duchamp.app/en/pricing。
• 内容会在发布日期出现。网站上未列出的 ID 暂不可用。

隐私

Duchamp 会存储您的账户、使用记录、已保存的项目、看板和关注的广告主页面。如果您将广告账户连接到 Performance，Duchamp 只会为您的账户存储该账户的广告元数据和每日表现数据（以及加密的只读访问令牌）——绝不会存入公共库或团队；当您关闭该账户、断开连接，或在 Facebook 设置中移除应用时，Duchamp 会删除这些数据。只有在您于 Performance 连接页面允许某个 AI 应用后，表现数据才会发送给该应用。传递给 compose_transfer_brief 的产品事实不会被存储。渲染后的文件会保留在您的设备上。Duchamp 不会针对您的请求调用模型。每个视频在被收集时只会生成一次语音转录。Duchamp 不会复制广告。已登录的广告研究结果中可能包含 Duchamp 镜像站上的创意素材 URL。参考标签不包含创意素材文件。

Duchamp 不会：

• 生成人脸、人物肖像、换脸、深度伪造或合成语音。Duchamp 不会创建真实人物的合成媒体。
• 克隆声音、生成音频或音乐、制作成人内容，也不提供 AI 伴侣或关系功能。
• 模板：不展示或重新托管他人的帖子或账户。模板不包含原始文案、图片或账户名称。
• 广告研究：已登录的调用方会获得 Duchamp 镜像站上的创意素材 URL。工具结果中的内嵌图片是供 Agent 使用的低分辨率预览。向用户展示时，请链接 duchamp_url。参考标签仍不包含创意素材文件。Duchamp 不会复制广告。
• 安排发布或发布内容。Performance 只会读取您自行连接的广告账户（Meta，只读，ads_read），用于生成表现报告。不进行服务器端内容生成，不自动执行互动操作，也不会访问用户不拥有的任何账户。
• 汇总或转售个人数据，也不保证表现结果。

原创帖子相关权利仍归其权利人所有。如需申请下架某个模板，请将原始 URL 发送至 [email protected]。

链接

• duchamp.app · 英文概览 · 连接 · 定价
• llms.txt · llms-full.txt
• 公司：Notique，Seoul · 联系方式：[email protected]

许可证

MIT。详见 LICENSE。