🔌 MCP对接指南

将广告数据
连接到您的AI工具

将KoreanAds MCP服务器与Claude、ChatGPT、Cursor等AI工具集成后，通过对话即可搜索广告、构建媒体组合、生成全漏斗策略和分析市场价格。

1499 广告产品
745 价格已验证商品
1238 A/B级质量商品
63 媒体子类型
📡

什么是MCP？

模型上下文协议（MCP）是一种开放协议，使AI模型能够访问外部数据和工具。KoreanAds通过MCP服务器提供12种专业工具，使AI工具能够实时访问韩国广告产品数据库并生成专业广告策略。

核心使用场景

KoreanAds MCP 旨在让广告发现、比较判断和预算分配都在 AI 对话中完成。

Find

根据简报和预算，用自然语言寻找合适的韩国广告商品。

Evaluate

基于价格可信度和受众/定向证据解释商品为何合适。

Allocate

仅用有价格依据的商品生成可执行的媒体组合。

从简报到外联的一体化流程

这一页不只是协议说明，而是围绕真实策划与销售沟通流程来组织内容。

代理商策划

向模型说明目标人群、预算和 KPI 后，KoreanAds MCP 会给出带证据的媒体 shortlist。

品牌采购评估

先比较候选商品、确认价格证据，再准备联系媒体方或销售团队的话术。

全球团队交接

借助多语言界面和结构化 MCP 响应，把韩国库存信息传达给非韩语团队成员。

🛠️ 可用工具

通过MCP可使用12种专业工具

🔍 搜索·查询

🔍 search_ad_products

通过自然语言搜索广告产品。支持向量语义搜索+SQL备选双模式，可按预算、子类型、质量分数筛选。

query 必填 — 搜索关键词（支持任何语言）
media_type 选填 — 媒体类型（数字、TV、户外等）
media_subtype 选填 — 媒体子类型（搜索、展示、社交、视频等）
max_budget_krw 选填 — 最大预算（韩元）
min_quality_score 选填 — 最低质量分数（0-100）
top_k 选填 — 最大结果数（默认5）
📋 get_product_detail

查询特定广告产品的完整详细信息，包括价格、定向投放、规格、KPI基准等所有信息。

product_id 必填 — 产品ID
⭐ get_top_quality_products

按数据质量分数排序浏览优质广告产品。无需关键词即可探索可用产品。

limit 选填 — 最大结果数（默认10）
media_type 选填 — 媒体类型（数字、TV、户外等）
media_subtype 选填 — 媒体子类型（搜索、展示、社交、视频等）
🏢 get_media_owner_portfolio

查询特定媒体主（如Kakao、Naver、Toss等）持有的全部广告产品组合和价格范围。

media_owner_name 必填 — 媒体主名称

📊 分析·策略

🎯 recommend_for_brief

根据投放简报返回基于数据库证据的广告商品推荐。输出经验证的候选商品和简短规划提示的 grounded JSON。

brief 必填 — 投放需求
budget 选填 — 预算
media_type 选填 — 媒体类型（数字、TV、户外等）
media_subtype 选填 — 媒体子类型（搜索、展示、社交、视频等）
📊 build_media_mix_from_db

仅使用价格验证的实际广告产品自动生成媒体组合。按质量加权计算各渠道占比和预算。

brief 必填 — 投放说明
monthly_budget_krw 必填 — 月度预算（韩元）
media_type 选填 — 媒体类型（数字、TV、户外等）
media_subtype 选填 — 媒体子类型（搜索、展示、社交、视频等）
🔄 generate_full_funnel_strategy

基于数据库产品自动生成认知→考虑→转化三阶段全漏斗营销策略。预算按40/30/30分配。

brief 必填 — 投放需求
monthly_budget_krw 必填 — 月度预算（韩元）
💰 analyze_market_pricing

按媒体类别分析市场定价基准。提供CPM/CPC/CPV的最低/平均/最高单价和预算基准。

media_type 选填 — 媒体类型（数字、TV、户外等）
media_subtype 选填 — 媒体子类型（搜索、展示、社交、视频等）

⚡ 实用工具

⚖️ compare_products

将2-5个广告产品在价格、定向投放、计费方式和KPI维度上并排对比。

product_ids 必填 — 产品ID列表（2-5个）
📈 simulate_campaign_perf

输入特定广告产品和预算，基于CPM/CPC/CPV单价模拟预期展示量、点击量和观看量。

product_id 必填 — 产品ID
budget_krw 必填 — 预算（韩元）
🧭 check_db_coverage

判断用户查询是否在广告数据库范围内的路由工具。自动区分趋势分析、文案撰写等数据库外请求。

query 必填 — 搜索关键词（支持任何语言）
📉 get_db_stats

查询数据库整体统计：总产品数、媒体类型分布、数据完整度和平均质量分数。

— No parameters required —

🌐 接入端点

根据您的使用场景选择合适的接入端点

推荐

Streamable HTTP

https://koreanads.com/mcp

最新MCP标准。Claude Desktop、Cursor等大多数客户端均支持。

旧版

SSE (Server-Sent Events)

https://koreanads.com/sse

兼容旧版MCP客户端的SSE接入端点。

ChatGPT

OpenAPI Actions

https://koreanads.com/openapi-actions.json

这是可直接导入到 Custom GPT Actions 的精简 OpenAPI schema。在 ChatGPT 中建议使用 HTTP Actions，而不是 MCP。

ChatGPT Custom GPT / HTTP Actions

如果你想让 Custom GPT 通过直接 HTTP Actions 调用 KoreanAds，就使用这条路径。它与 MCP Apps 路径分离，可通过 HTTP 调用搜索、对比、详情和媒体组合接口。

1

打开 Custom GPT

在 ChatGPT 中打开 Create a GPT 或已有 GPT，然后进入 Configure 标签并打开 Actions。

2

导入 OpenAPI

将下面的 URL 粘贴到 Actions 的 schema URL 输入框中。

OpenAPI URL
https://koreanads.com/openapi-actions.json
3

粘贴 Instructions

把下面的文本原样粘贴到 Instructions。默认原则是 <strong>优先 API，优先 grounded JSON</strong>。

Custom GPT Instructions
请直接使用 HTTP API。

优先使用的工具：
- 广告商品搜索：POST /api/tools/search
- 商品详情查询：GET /api/tools/products/{product_id}
- 商品对比：POST /api/tools/compare
- DB 统计查询：GET /api/tools/stats
- 媒体主产品组合查询：GET /api/tools/media-owner-portfolio
- 媒体组合生成：POST /api/strategy/media-mix
- 基于简报的 grounded 推荐：POST /api/strategy/recommend

运行规则：
- 尽量优先使用直接的 JSON 工具调用，而不是生成长篇说明文字。
- 在 MCP 中只使用 grounded JSON 结果。
- 如果用户想找广告商品，先调用 /api/tools/search。
- 如果用户想比较 2 到 5 个已知商品，调用 /api/tools/compare。
- 如果用户想查看某一个商品的详情，调用 /api/tools/products/{product_id}。
- 如果用户想要预算分配或媒体计划，调用 /api/strategy/media-mix。
- 如果用户想要基于简报的推荐，调用 /api/strategy/recommend。
- 回答时先基于工具结果中的事实和数字，再在必要时补充简短说明。
- 不要编造 API 结果中不存在的商品属性或价格信息。
- 如果后续工具需要 product ID，先从搜索结果中找到 ID 再继续调用。
- 不要生成冗长的策略文档。
4

使用方式

搜索、对比、详情、统计和推荐都优先直接使用 Action 返回的 JSON 结果。Apps 和 Actions 在同一个 GPT 中不能同时启用。 叙述式 LLM 生成不属于 MCP 范围。

⚙️ 对接方法

请按照您使用的AI工具的设置步骤操作

1

打开配置文件

Claude Desktop → Settings → Developer → Edit Config

或直接编辑文件：

macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\claude_desktop_config.json
2

注册MCP服务器

将以下JSON添加到配置文件中：

claude_desktop_config.json
{
  "mcpServers": {
    "koreanads": {
      "url": "https://koreanads.com/mcp"
    }
  }
}
3

重启Claude

保存设置后重启Claude Desktop，工具列表中将出现KoreanAds。

1

打开MCP设置

Cursor → Settings → MCP标签页

2

添加服务器

点击+ Add new MCP server，输入以下信息：

.cursor/mcp.json
{
  "mcpServers": {
    "koreanads": {
      "url": "https://koreanads.com/mcp"
    }
  }
}
3

开始使用

在Agent模式下，使用'搜索韩国广告产品'等自然语言即可调用MCP工具。

1

在ChatGPT中对接

请在 ChatGPT 网页版中进入 Settings → Apps。是否可用取决于你的套餐和工作区权限。若要注册自定义 MCP App，请先开启 developer mode，再使用 Apps → Create 或 Workspace Settings → Apps → Create。

2

输入服务器URL

请输入远程 MCP 服务器 URL。ChatGPT 目前不支持本地 MCP 服务器，因此必须使用公开 HTTPS 端点：

MCP Server URL
https://koreanads.com/mcp
3

连接并同步更新

请在新对话中从 Apps 菜单选择 KoreanAds 使用。管理员首次批准后，ChatGPT 会固定当前工具快照，因此后续若 MCP 工具发生变化，必须到 Workspace Settings → Apps → Refresh，然后再次 Publish。

1

通过HTTP直接连接

使用MCP客户端库进行编程连接：

Python (fastmcp)
from fastmcp import Client

async with Client("https://koreanads.com/mcp") as client:
    result = await client.call_tool(
        "search_ad_products",
        {"query": "20대 여성 타겟 SNS 광고"}
    )
    print(result)
TypeScript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://koreanads.com/mcp")
);
const client = new Client({ name: "my-app", version: "1.0" });
await client.connect(transport);

const result = await client.callTool({
  name: "search_ad_products",
  arguments: { query: "20대 여성 타겟 SNS 광고" }
});
2

SSE旧版方式

旧版MCP客户端请使用SSE接入端点：

SSE URL
https://koreanads.com/sse

🚀 立即开始

将 KoreanAds 连接到您的 AI 工具，通过对话完成广告搜索、商品对比和媒体组合生成。

试试广告搜索 媒体组合推荐