content-genie

content-genie-mcp

面向韩国内容创作者的 MCP，让 Claude 获取 Naver、Daum、Google、YouTube、Zum 的实时趋势、包含 100 多个韩国节日的数据库和病毒式传播评分预测器——发布每篇内容前，无需再在 5 个趋势面板之间来回切换。

English · 한국어

---

为什么选择 content-genie？

大多数“趋势”MCP 只是 Google Trends 的简单封装。如果你的受众是韩国用户（Naver Blog、YouTube Korea、Instagram KR、TikTok），仅靠 Google 会错过关键信号——Naver Datalab、Daum 搜索、Zum 实时趋势，以及韩国地区的 YouTube 各自在不同时间呈现不同的关键词。content-genie 将全部五个来源整合到一个 MCP 中，并加入包含 100 多个韩国节日、14 日日期系列和节气事件的数据库，让 Claude 无需提示就能围绕 빼빼로데이 和 수능 进行规划；最后通过一个病毒式传播评分预测器完善整个流程，该预测器根据能提升韩国内容点击率的结构模式（数字、括号、情绪触发词、紧迫感词语）进行训练。

Phase 4 重构（v2.12.0，2026 年 5 月）让整个项目足以安全依赖：每个爬虫都由按来源隔离的熔断器（失败 3 次后开启 5 分钟）保护，并提供过期缓存回退。因此，Naver 的 HTML 变更不再会导致整个 MCP 服务宕机——只会使对应来源降级，并通过 resource://content-genie/sources 告知大模型。

v2.12.0 新增内容

• 17 个工具、一个注册表、六个小文件。 旧版 4,712 行的 index.ts 已移除——工具现在位于 src/tools/{trends,seo,contentIdeas,viralScoring,competitorAnalysis,koreanEvents}.ts 中。添加工具只需一行代码。
• 爬虫不再会导致服务宕机。 按来源隔离的熔断器 + LRU/TTL 缓存（15 分钟，100 个条目）+ 过期缓存回退。Naver 降级时，Claude 会看到 source_status: 'stale' 并作出调整。
• 新增两个可通过 @-mention 引用的 MCP 资源。 resource://content-genie/korean-events/{year} 返回调整到任意年份的完整事件数据库；resource://content-genie/sources 提供实时熔断器和缓存状态。
• 两个 MCP 提示词，作为引导式工作流。 viral-title 按顺序调用 optimize_title_hashtags → predict_viral_score → generate_ab_test_variants。competitor-analysis 执行 URL 分析和差距补全式创意构思。
• 8 个测试套件共 38 项测试。 涵盖熔断器状态转换、缓存淘汰、爬虫回退路径、SSRF 防护和所有工具组——在 CI 中使用 Node 22 + 24 运行。

5 分钟快速入门

# 1. Install via Claude Code (recommended)
claude mcp add content-genie -- npx -y content-genie-mcp

# 2. Or add to Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "content-genie": {
      "command": "npx",
      "args": ["-y", "content-genie-mcp"]
    }
  }
}

3. 重启 Claude Desktop（或者 claude 会在下次运行时自动加载）。
4. 在 Claude 中尝试：

오늘 한국에서 뜨는 키워드 5개로 유튜브 쇼츠 제목 후보 3개씩 만들고, 각각 바이럴 점수 등급 매겨줘.

5. 预期结果：Claude 调用 get_korean_trends（合并 naver+daum+google+youtube+zum 的数据）→ 对每个关键词调用 optimize_title_hashtags → 调用 predict_viral_score → 返回按排名排列的 S/A/B/C/D 评级表，并附上结构原因（“标题包含数字 + 好奇心触发词”）。

实际用例

1. “我需要一个明天也不会过时的韩语博客选题”

问题： Naver Blog 会优先推荐紧跟当下热门关键词的内容，但这些关键词每 4 小时就会变化一次。 使用这个 MCP： Claude 调用 get_korean_trends({ platform: 'naver', limit: 20 })，然后针对最新的 5 个关键词调用 generate_content_ideas，并设置 seasonal: true。季节性层会从 100 多条数据的数据库中添加即将到来的韩国活动，因此建议内容不只是“AI 推荐工具”，而是“AI 推荐工具 + 高考 D-30 内容策划”，因为 get_seasonal_content_guide 发现距离高考还有 4 周。 为什么比 Naver Datalab UI 更好： Datalab 给你一张图表，而这个 MCP 会根据相同的趋势，在一次对话往返中为你生成 5 篇带标题、针对标签优化的帖子草稿。

2. “这个 YouTube Shorts 标题真的会火吗？”

问题： 标题点击率是影响 Shorts 表现的最大因素，但发布之后你才能知道效果如何。 使用这个 MCP： 把草稿贴给 Claude，然后说“使用 viral-title 提示词”。该提示词会依次调用 optimize_title_hashtags → predict_viral_score → generate_ab_test_variants，并返回 S～D 评级和 5 个 A/B 版本，同时列出结构上的变化（添加数字、添加紧迫感词语、缩短至 25 个字符）。 为什么比凭感觉判断更好： 评分器会读取韩国文案撰写者也会关注的 6 类信号——情绪触发词（충격|실화|숨겨진）、结构元素（数字／方括号／?／!）、紧迫感、社会认同、实用性表达（방법|꿀팁|노하우）和长度范围——并告诉你缺少哪些信号。

3. “我经营一个韩国小品牌，需要一份兼顾当地节日的内容日历”

问题： 通用日历工具不了解 빼빼로데이、김장철、수능 或 한가위 연휴，所以你最终可能会在 현충일 发布促销内容。 使用这个 MCP： Claude 调用 create_content_calendar({ months: 3, niche: 'beauty' })，将你未来 3 个月的时间范围与 100 多条活动数据库匹配（公休日 18 个 + 特别纪念日系列 12 个 + 节气 15 个 + 商业活动 15 个 + 季节／天气 12 个 + 入学考试 10 个 + 购物活动 10 个 + 创作者专属活动 8 个），并按日期生成计划，为每项活动提供内容主题。 为什么比 Notion 模板更好： 数据库会自动更新到任意年份（resource://content-genie/korean-events/2027 只需一次 @-mention 即可访问），因此即使到了明年，日历也依然准确，无需你手动维护。

工具 / 资源 / 提示词

名称	类型	功能
get_korean_trends	工具	Naver / Daum / Google / YouTube / Zum 的实时趋势，合并并去重
analyze_news_trends	工具	按类别分组的韩国新闻标题趋势
analyze_seo_keywords	工具	Naver + Google 自动补全 + 长尾词扩展
optimize_title_hashtags	工具	优化点击率的标题改写 + 各平台标签集
generate_hashtag_strategy	工具	各平台（IG/YT/TikTok/Naver）的标签组合，兼顾广度与深度
generate_content_ideas	工具	基于趋势、季节和细分领域生成创意
generate_script_outline	工具	长篇脚本 / 短篇逐场景大纲
repurpose_content	工具	一篇帖子 → 跨平台变体（博客 → Shorts → Reel → Thread）
predict_viral_score	工具	S～D 评级，并说明结构、情感和紧迫性方面的原因
generate_ab_test_variants	工具	生成 N 个 A/B 标题变体，每个变体调整一个要素
predict_content_performance	工具	启发式估算点击率 / 分享量 / 收藏量
analyze_thumbnail	工具	缩略图概念分析 + 点击率优化清单
analyze_competitor_content	工具	获取竞争对手帖子 URL（带 SSRF 防护）+ 差距分析
benchmark_content_performance	工具	按细分领域 / 平台提供行业基准数据
analyze_influencer_collab	工具	网红匹配度 / 受众重合度分析 / 简报生成器
create_content_calendar	工具	根据韩国活动数据库生成多月日历
get_seasonal_content_guide	工具	“接下来 2 周应该发布什么？”——结合活动信息
resource://content-genie/korean-events/{year}	资源	可重置为任意年份的完整 100+ 项活动数据库（JSON）
resource://content-genie/sources	资源	实时爬虫熔断器 + 缓存状态，用于优雅降级
prompt://content-genie/viral-title	提示词	优化 → 预测 → 生成 A/B 变体，一条斜杠命令即可完成
prompt://content-genie/competitor-analysis	提示词	获取 URL → 补齐差距的创意生成工作流

工作原理

                    Claude (or any MCP client)
                              │
                              ▼
                        McpServer (SDK 1.25)
                              │
                  ┌───────────┼───────────┐
                  ▼           ▼           ▼
              17 tools    Resources    Prompts
                  │
                  ▼
            runScraper()  ◄── core/cache.ts (LRU + 15min TTL)
                  │       ◄── core/circuitBreaker.ts (3-fail → open 5min)
                  ▼
         scrapers/{naver,daum,google,youtube,zum}.ts
                  │
                  ▼
            core/security.ts (SSRF + 30s timeout + 5MiB cap)

三个重要的设计选择：

1. 按来源设置熔断器。 Naver 状况不佳，不会影响其他 16 个工具——只影响依赖 Naver 的趋势工具，而且这些工具仍会返回带有 status: 'stale' 的过期缓存封装，以便大模型做出调整。
2. 爬虫绝不抛出异常。 它们会返回 ScrapeResult 封装（ok | stale | unavailable）。所有错误处理都集中在一处（runScraper），因此添加新来源只需“编写爬虫、返回 ScrapeResult，完成”。
3. 读取时重置活动数据库年份。 这份包含 100 多项韩国节日和活动的数据库按月-日规则存储，并会按需重置为任意年份，因此现在就能使用 …/korean-events/2027。

配置

环境变量	默认值	用途
MCP_HTTP_MODE	false	设为 true 可使用 Streamable HTTP 服务，而非 stdio
HOST	0.0.0.0	HTTP 绑定主机
PORT	3000	HTTP 绑定端口
CONTENT_GENIE_ALLOWED_HOSTS	韩国搜索 / 社交 / 电商站点允许列表	analyze_competitor_content SSRF 防护使用的逗号分隔主机允许列表。可覆盖此值以添加自己的竞争对手域名。

HTTP 端点（当 MCP_HTTP_MODE=true 时）：

方法	路径	用途
GET	/	服务信息
GET	/health	健康状态探测（Railway/Docker）
POST	/mcp	MCP JSON-RPC 请求（2025-03-26 规范）
GET	/mcp	用于服务端主动发送消息的 SSE 流

已知限制

• 抓取器由 HTML 驱动。 Naver / Daum / Zum 不提供公开的趋势 API；抓取器会解析 HTML。它们更改标记后，受影响的数据源会返回 status: 'unavailable'，直到我们发布解析器修复。在此期间，断路器会确保 MCP 的其余部分继续工作。
• 病毒式传播评分基于结构，而非语义。 predict_viral_score 是针对韩语文案模式的启发式评分。它无法理解帖子的含义——只能识别标题和描述中的结构、情绪和紧迫性信号。
• 不分析缩略图图片。 analyze_thumbnail 处理的是缩略图概念描述，而非上传的图片。图片输入已列入路线图。
• 以韩语为主。 话题标签模板、紧迫性用词和活动数据库均为韩语。v2.x 不在英语／日语模式的规划范围内。

不适用场景

• 如果你需要全球趋势看板，请直接使用 Google Trends——content-genie 专注于韩国创作者工具链。
• 如果你需要包含搜索量的付费关键词数据（네이버 검색광고 API、Ahrefs、SEMrush），请使用这些工具——content-genie 的 SEO 工具依赖免费的自动补全和启发式长尾词扩展。
• 如果你因合规要求需要不依赖大模型、结果确定的文案生成，请勿使用此 MCP——它会向大模型提供信息，实际标题由大模型撰写。

对比

	content-genie-mcp	自行抓取原始数据	Naver Datalab UI	SmartEditor / 네이버 검색광고 API
多数据源合并（5 个韩国数据源）	是	自行实现	仅 Naver	仅 Naver
内置韩语活动数据库	100 多个活动	否	否	否
断路器 + 缓存	是	自行实现	不适用	不适用
病毒式传播评分启发式算法	是	否	否	否
原生支持 MCP（Claude @-mention 事件）	是	否	否	否
成本	免费（npm）	开发时间	免费	超出配额后收费

路线图

• 更多数据源。 Tistory 实时趋势、Brunch 精选、Kakao View——目前有 5 个数据源，目标是增加到 8 个。
• 图片输入式缩略图分析。 接受上传的缩略图，并运行基于视觉的点击率评分。
• 缓存趋势资源。 暴露 resource://content-genie/trends/{platform}/latest，让大模型无需调用工具，就能通过 @-mention 引用最近一次抓取的结果。
• 视频脚本 → 字幕。 将 generate_script_outline 与字幕格式化器配合，用于上传 Shorts。
• 集成 Naver 검색광고 API（自选）。 用户提供 API 密钥后，将 SEO 工具从自动补全启发式算法切换为真实搜索量数据。

贡献

欢迎提交 PR。Phase 4 重构让代码库更便于贡献——添加工具只需修改单个文件。请参阅下方的 Contributing 部分；如果想讨论较大的更改，请先提 issue。CI 会在 Node 22 + 24 上针对每个 PR 运行 typecheck + test + build。

贡献者快速流程：

git clone https://github.com/MUSE-CODE-SPACE/content-genie-mcp
cd content-genie-mcp
npm install
npm run typecheck && npm test && npm run build

安全

此 MCP 会抓取第三方 URL，并接受由大模型驱动的输入。威胁模型、SSRF 主机允许列表、30 秒抓取超时 + 5 MiB 正文大小上限，以及 CONTENT_GENIE_ALLOWED_HOSTS 覆盖配置，均记录在 SECURITY.md 中。请通过 GitHub Security Advisory 私下报告漏洞：https://github.com/MUSE-CODE-SPACE/content-genie-mcp/security/advisories/new。

许可证

MIT — SPDX 标识符已在 package.json 中声明（顶层 LICENSE 文件将在下个版本中添加）。

维护者

@yoon-k（MUSE-CODE-SPACE）。如需支持，请提交 issue：https://github.com/MUSE-CODE-SPACE/content-genie-mcp/issues。

---

한국어 요약

content-genie-mcp는 한국 콘텐츠 크리에이터를 위한 MCP 서버입니다. 네이버 / 다음 / 구글 / 유튜브 / 줌 5개 소스의 실시간 트렌드를 한 번에 합쳐 보여주고, 100+ 한국 기념일/이벤트 DB(공휴일 18, 데이 시리즈 12, 절기 15, 상업 이벤트 15, 시즌/날씨 12, 입시 10, 쇼핑 10, 크리에이터 특화 8)와 바이럴 점수 예측기(S~D 등급, 한국어 카피 패턴 기반)를 함께 제공합니다.

v2.12.0(2026-05-20)에서 17개 도구가 도메인별로 모듈화되었고, 스크래퍼별 회로 차단기 + LRU 캐시 + stale fallback 으로 한 소스가 망가져도 나머지가 정상 동작합니다. @-mention 가능한 MCP Resources 2개와 슬래시 명령용 Prompts 2개도 추가되었습니다.

설치 (Claude Code):

claude mcp add content-genie -- npx -y content-genie-mcp

첫 호출 예시:

오늘 한국에서 뜨는 키워드 5개로 유튜브 쇼츠 제목 후보 3개씩 만들고, 각각 바이럴 점수 등급 매겨줘.

자세한 내용은 영문 섹션, 변경 이력은 CHANGELOG.md, 위협 모델은 SECURITY.md를 참고하세요.