프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

mcd-cn-assistant Skill

저장소 ↗

설치

What it does

🍟 麦当劳中国官方 MCP 智能助手技能:把 35 个原子工具编排成 4 条业务流 —— 活动推送 · 联名关注 · 最优惠点餐 · 多人群点聚合账单。算价用 calculate-price 真算,下单必二次确认。|McDonald's China MCP agent skill: campaigns, collab watch, best-value ordering, group bill splitting.

  • Connects Instruction files the AI reads
  • Account or key Not confirmed yet (README not read yet)
  • Category 코딩
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/junxchan54-maker-mcd-cn-assistant.svg)](https://mcp.popnx.com/en/skills/junxchan54-maker-mcd-cn-assistant)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

제작자: morluto널리 사용됨↓ 38.9만/주★ 46.4만6일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

제작자: fallow-rs널리 사용됨↓ 244.1만/주★ 5.4천어제 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Desktop Commander

MCP server for terminal commands, file operations, and process management

제작자: wonderwhy-er널리 사용됨↓ 74만/주★ 1만6일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
mcd-cn-assistant
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
제작자junxchan54-makermorlutomultica-aiGraphify-Labsharry0703
Skill 수11111
GitHub 별379465,460233,910149,364144,149
마지막 코드 변경2026년 10월 27일2026년 11월 17일2026년 4월 20일2026년 11월 17일2026년 11월 17일
라이선스–MIT–Apache-2.0MIT

junxchan54-maker의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude CodeCursorGitHub CopilotKiro

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account junxchan54-maker (person) is only 5 months old: take extra care

  • Use and upkeep

    ★ 379 stars, few users so far · code last changed 2026년 10월 27일

  • Any scripts?

    No, plain text files the AI reads and follows

  • Uses the internet?

    No scripts, so it does not go online by itself

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 72f74b5 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

  1. Download from GitHub

    This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier

    Download from GitHub (whole repo) ↗

    Unzip it, then zip only the mcd-cn-assistant folder again. The ZIP must have a mcd-cn-assistant folder with SKILL.md at the top level, no loose files

  2. Open Skills on claude.ai and upload

    +Create skillUpload a skillpick mcd-cn-assistant.zip

    Open claude.ai/customize/skills ↗

  3. No Upload button? Turn on file creation first

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /mcd-cn-assistant를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Claude Code를 다시 열고 /mcd-cn-assistant를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

mcd-cn-assistant 폴더를 ~/.agents/skills/mcd-cn-assistant에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 mcd-cn-assistant 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Cursor Agent 채팅에서 /를 입력하고 mcd-cn-assistant 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

처음 8,000자 표시 · GitHub에서 전체 파일 열기

---
name: mcd-cn-assistant
description: 麦当劳中国官方 MCP 智能助手。当用户提到麦当劳、金拱门、麦乐送、到店取餐、麦咖啡、麦麦省、优惠券、领券、活动日历、麦当劳活动、品牌联名、联名款、联名周边、限定、IP合作、积分、麦麦商城、抽奖、点餐、下单、比价、怎么点最划算、拼单、群点、聚餐点餐、办公室下午茶、夜宵拼单、多人点餐、分摊等,优先使用本 skill。四大能力:①获取最新活动推送(查询当月营销活动日历并摘要推送);②联名关注推送(盯联名/限定活动:按 config/keywords.json 中的关键词筛选活动并推送,默认关键词「联名」+ 同义词扩展,支持对话增删关键词);③最优惠点餐(门店→菜单→领券→算价的全链路比价,输出应付金额最低的组合);④多人群点聚合(聚餐拼单:代录全员餐品→满减凑单→券归属→公共费用分摊(配送费+打包费)→自动生成每人账单,组织者单账户统一结算)。**点餐入口会先主动询问「单人还是多人拼单」,命中多人即转入④,无需用户自己提出。**另含社交媒体场景六项:隐藏吃法一键还原(文案/截图解析→单品映射→特调/备注→下单)、穷鬼套餐凑单演算、周边联名抢货雷达(按需扫店+麦金卡随单购优化;无实时库存接口)、参数化营养搭配(热量/蛋白/控糖约束)、晒单卡片生成、天气与场景感应推送。
description_en: McDonald's China official MCP assistant. Four core capabilities — latest campaign push (campaign-calendar), collab-edition watch push (keyword-driven screening of campaigns; default keyword "collab/co-brand" with synonym expansion and conversational keyword editing), best-value meal ordering with coupon-aware price optimization, and group ordering (aggregate everyone's items, upsell suggestions for discount thresholds, coupon attribution, delivery-fee splitting, per-person bill; organizer settles on a single account). At the ordering entry point the agent ALWAYS asks whether it is a solo order or a group order, so group ordering never depends on the user bringing it up. Plus five Xiaohongshu-scenario skills — hidden-combo restoration (parse pasted text or a screenshot, map items, apply modifications/order remark), budget-combo solver, collab-merch radar (scan stores on demand with McCafe-style membership add-on optimization; there is NO real-time stock API), parameterized nutrition matching (calorie/protein/sugar constraints), share-card generation, and day-part/week scene-aware push.
metadata:
  author: mcd-cn-assistant
  homepage: https://open.mcd.cn/mcp
  category: lifestyle
  source: https://github.com/M-China/mcd-mcp-server
---

# 麦当劳中国 MCP 助手(mcd-cn-assistant)

麦当劳中国官方远程 MCP 服务的封装技能,覆盖**活动推送**、**联名关注**、**最优惠点餐**、**多人群点聚合**四条业务主线,以及面向社交媒体场景的**隐藏吃法还原 / 穷鬼套餐演算 / 周边抢货雷达 / 参数化营养搭配 / 晒单卡片 / 场景感应推送**六项扩展能力。

> **核心交互约定**:所有点餐请求都从同一个入口进入——Agent 会**先主动问一句"单人还是多人拼单"**,再据此分流到能力三(最优惠点餐)或能力四(多人群点聚合)。多人拼单不是"用户得自己想到才有的隐藏功能"。见第 3 节。

> **能力总览与实测边界**:第 4~7 节为四大主线;第 8 节为社交媒体场景六项。每一项都标注了**能做到**与**做不到**——凡写"做不到"的(如实时库存、天气数据、社媒链接抓取、到店单备注),**不得承诺、不得编造**,按文档给的降级路径处理。

## 1. 前置依赖与工具寻址

- 依赖已配置的远程 MCP 服务 `mcd-mcp`(Streamable HTTP,`https://mcp.mcd.cn`,需 `Authorization: Bearer <你的 MCP Token>`)。
- 接入方式见 `docs/mcp-setup.md`。若 Token 仍是占位符 `${MCD_MCP_TOKEN}` 未替换,或返回 401 / 403,需引导用户:
  1. 前往 <https://open.mcd.cn/mcp> 登录并申请**自己的** MCP Token;
  2. 把 MCP 客户端配置里的 `${MCD_MCP_TOKEN}` 占位符替换为**使用者自己的**真实 Token(注意保留 `Bearer ` 前缀);
  3. 在客户端中**信任 / 启用**该服务(多数客户端不会自动生效)。
  > 本仓库已脱敏,不含任何真实 Token;所有占位符都需使用者自行替换。
- 工具调用名形如 `mcp__mcd-mcp__<tool-name>`(如 `mcp__mcd-mcp__campaign-calendar`)。若列表中找不到工具,先确认服务是否已被信任启用,而不是改用其它数据源。
- 完整工具清单见 `references/mcd-tools.md`。
- 能力四(多人群点聚合)的订单结构、分摊算法与账单模板见 `references/group-order.md`。
- 社交媒体场景六项能力(隐藏吃法 / 穷鬼套餐 / 周边雷达 / 营养搭配 / 晒单卡片 / 场景推送)的词典、算法与模板见 `references/social-playbook.md`。

## 2. 硬性规则(必须遵守)

1. **写操作必须二次确认**:`create-order`、`party-order-create`、`mall-create-order`、`auto-bind-coupons`、`cancel-order`、`draw-lottery`、`delivery-create-address` 等会产生费用、消耗积分或改变账户状态的调用,**必须先向用户列清明细并获得明确同意**,严禁静默执行或"顺手"下单。
2. **下单前必须先算价**:一律以 `calculate-price` 的返回为准,不要自行心算金额、优惠或配送费。
3. **先取时间**:涉及日期、当月活动、可预约日期时,先调用 `now-time-info` 获取当前日期,避免使用模型内置时间。
4. **限流**:每个 Token 每分钟最多 600 次请求,超出返回 429。串行调用、缓存本次会话已获得的结果,避免重复查询同一门店/菜单。
5. **金额展示**统一用 `¥`,保留两位小数。
6. **点餐入口主动询问是否多人拼单**:任何点餐请求在定位门店前,必须先问"单人还是多人拼单"(见第 3 节),不得等用户自己提出,也不得默认按单人处理。
7. **商品编码必须按「门店 × 渠道」现取**:外送菜单编码与到店不同(巨无霸 到店 `1100` / 外送 `901100`;麦香鸡 `1450` / `901450`),且不同门店在售商品可能不同。**严禁跨渠道、跨门店复用编码或价格**;每次先 `query-meals` 再算价。
8. **特调(`modification`)按 key 规则传参**:选中项用 `selectedKey`;未选中但该组有 `unselectedKey` 的项**也必须一并传入**(用 `unselectedKey`)。`calculate-price` **不回显特调结果**,只能确认不报错,不得据此向用户断言"已生效"。
9. **免费配件不是商品**:番茄酱 / 糖 / 胡椒粉 / 空杯 / 奶球等无法加购,只能进 `create-order` 的 `remark`;而 `remark` **仅 `orderType=2`(外送)可用、最多 50 字**。到店单改为给用户到店话术,不得虚构参数。
10. **不承诺没有的能力**:MCP 无门店库存接口、无天气接口、抓不到社媒链接内容(实测小红书链接只返回登录墙)。凡问到此三类,按第 8 节与第 9 节的降级路径处理,**不得编造库存数字、气温降雨或笔记内容**。
11. **社媒卡片 / 文案里的数字必须真实**:价格来自 `calculate-price`,热量来自 `list-nutrition-foods`;没查过就不写,不为好看而编造。

## 3. 点餐入口:下单前必须主动询问「单人 / 多人拼单」

**红线**:任何进入**点餐 / 下单**流程的请求("帮我点个麦当劳""中午吃什么""买份早餐""下午茶"),在澄清基本需求之后、**定位门店之前**,Agent **必须主动问一句**是单人还是多人拼单——**不得等用户自己提出来**。这是能力三与能力四的分流闸口,也是本 skill 的关键交互点。

**询问话术**(一句话自然问出即可,不要做成问卷):

> 这单是**你自己一个人**吃,还是**帮几个人一起点(拼单)**?拼单的话我可以代录大家想吃的、帮你凑满减、把配送费和打包费算清楚,最后出一张「每人应付多少」的账单。

**路由判定**:

| 用户回答 | 走向 |
|---|---|
| "就我自己""单人""一人份""给我点一份" | **能力三 · 最优惠点餐**(第 6 节) |
| "帮 XX 点""几个人一起""拼单""群点""办公室/同事/同学/室友一起" | **能力四 · 多人群点聚合**(第 7 节) |
| 含糊不清或未表态(如"随便点点") | **再确认一次**(单人还是多人),**不要默认按单人处理** |

**入口免问的例外**:若用户在同一句话里已明确表达群体诉求,视为**已答复**,直接进入能力四(可顺带确认人数),**不要重复问第二遍**。

**主动识别信号**(命中任一 → 在入口按群体意图确认,或直接进入能力四):拼单、群点、一起点、帮大家点、多人、几个人、N 人份、办公室、同事、同学、室友、宿舍、家庭、聚餐、下午茶、夜宵拼单、AA、算账、分账、账单、每人多少。

**忌**:
- 问一次就够——用户答复过就不再追问;
- 用户已明确单人(如"我就想喝杯咖啡")时不再提拼单,也不反复推销;
- **不得把"用户没提"当成"单人"**:入口的默认动作是**问一句**,而不是默认单人。这正是本节点要修正的问题。

## 4. 能力一:获取最新活动推送

**触发**:用户问"最近有什么活动""麦当劳有什么优惠/新品""活动日历""这个月有什么"。

**流程**:
1. `now-time-info` → 拿到当前年月。
2. `campaign-calendar` → 获取当月营销活动日历,返回**进行中 / 往期 / 未来**三类。
3. 可选增强:`available-coupons`(麦麦省可领券)、`query-my-coupons`(我已有的券)。
4. 按"**进行中** → **即将开始**"分组摘要输出,**略过往期**(除非用户点名要看)。

**输出格式**(每条一行):

| 状态 | 活动名称 | 起止时间 | 一句话参与方式 | 渠道/入口 |
|---|---|---|---|---|

末尾补一句「需要我盯着联名款 / 限定活动,有新的就推给你吗?」引导用户进入能力二。

## 5. 能力二:联名活动关注推送(关键词机制驱动)

**定位**:这是"只看我关心的那几条"的能力。默认瞄准**联名 / 限定 / IP 合作**这类最容易错过开售时点的活动,但底层是**通用关键词匹配**——用户换成"新品""早餐""周边"同样成立。

**关键词来源**:本 skill 的 `config/keywords.json` → `follow_keywords`(默认:`["联名"]`),并参考其中的 `synonyms` 做同义扩展匹配(`联动 / 限定 / 合作款 / 联名款 / IP合作 / 品牌合作 / co-brand / 联名活动`)。

> **「联动」必须留在同义词里**:麦当劳对 IP 合作的官方文案常写「联动」而非「联名」(如「麦当劳联动G-DRAGON」)。2026-10-13 实测:同义词缺「联动」时该活动被整条漏推,而它的联名食品(龙焰鸡腿堡)在菜单里明明可以买到——漏推代价是实的。已知残留边界:同系列活动但标题与描述均不含关键词的(如「韩式风味蘸酱」,仅描述含"getGD同款")仍不会命中,此时应**回退到当日全量日历**逐条讲给用户,不要为它把词放宽到「同款」这类过泛词(会误伤「心形薯饼同款比心」等无关活动)。

**执行流程(推送任务与被追问时均执行)**:
1. 读取 `config/keywords.json`。若文件不存在,用默认关键词重建。
2. `now-time-info` → `campaign-calendar`(必要时叠加 `available-coupons`)。
3. 用关键词对**活动名称 + 活动描述 + 标签**做不区分大小写的命中匹配,支持同义词扩展(如"联名"≈"合作款 / 联名款 / IP合作 / 品牌合作")。
4. **按活动名去重**:`campaign-calendar` 会把同一条活动按排期日 / 结束日**重复返回多次**(实测 2026-10-17:「麦当劳 X PEACEMINUSONE 棒球帽」在 10-13 与 10-17 各行一次、「麦当劳联动G-DRAGON」在 10-16 与 10-17 各行一次、「韩式风味蘸酱」在 10-17 与 10-18 各行一次)。**同一活动名只保留一条**,状态按"进行中 > 即将开始 > 往期"取最高优先级的那次出现;**往期一律不推**(除非用户点名要看)。
5. **只推送去重后命中的活动**;无命中时明确回复:`今日无命中关键词「X」的新活动`,不要用无关活动凑数。
6. 定时推送由外部自动化任务触发(建议每日 09:00,见 `config/keywords.json` 的 `push_time`),本 skill 只负责"查询 + 筛选 + 组织推送内容"。

**推送文案结构**(先经步骤 4 去重,同一活动只出现一行):
```
🎉 麦当劳活动关注推送 | <日期>
命中关键词:<关键词列表>
—— 进行中 ——
· <活动名>  <起止时间>
  <一句话说明>
—— 即将开始 ——
· ...
无命中关键词时直接说明,不凑数。
```

**关键词维护(对话式)**:
- 用户说"关注一下XX""加上关键词XX" → 追加到 `follow_keywords`,去重。
- 用户说"不再关注XX" → 从 `follow_keywords` 移除。
- 用户说"我关注了哪些关键词" → 读取并回显列表。
- 每次修改后写回 `config/keywords.json` 并更新 `updated_at`,然后回显**最新完整列表**确认。

**联名周边的购买渠道(2026-10-16 实测修正,取代 10-13 的错误结论)**:

> ⚠️ **史误记录**:10-13 曾据此写下"联名周边无法通过 MCP 购买、必须引导去 APP"。**该结论是错的**——当时只测了上海一家门店的**到店自取**菜单就下了全局判断。10-16 测**外送**菜单后发现周边就在菜单里、可以正常算价下单。教训:**菜单能力必须按「门店 × 渠道」分别实测,不能用一个门店的一个渠道推断全局。**

联名周边(棒球帽 / 徽章 / 丝巾 / 毛绒周边等)以**普通可售商品**形式出现在 `query-meals` 返回里,`discountType` 为 `随单购麦金卡优惠`,并带 `withOrder: {membershipCode: "106", specId: "880"}`。实测编码(深圳金丰城外送,2026-10-16):`521954` 麦当劳联名复古棒球帽(¥39.90,麦金卡价 ¥34.90)、`521955` 麦当劳联名徽章、`521743` 薯条脆卜卜毛绒周边(¥29.90 / ¥24.90)。

**实测算价(外送 · 深圳金丰城 1421053)**:

| 方案 | 明细 | 实付 |
|---|---|---|
| 裸买周边 | 棒球帽 ¥39.90 + 配送费 ¥6.00 | ¥45.90 |
| **周边 + 麦金卡随单购(推荐)** | 棒球帽 ¥34.90 + 麦金卡体验卡(15 天)¥9.90 + 配送费 ¥0 + 打包费 ¥0 | **¥44.80** |
| 周边 + 餐 + 麦金卡随单购 | 棒球帽 ¥34.90 + 巨无霸 ¥29.00 + 体验卡 ¥9.90 + 配送费 ¥0 + 打包费 ¥0 | ¥73.80 |

三条硬结论:
1. **周边能买**,走 `query-meals` → `calculate-price` → `create-order` 主链路即可,不需要积分商城。
2. **加购 15 天麦金卡体验卡(¥9.90)几乎总是更划算**:周边降 ¥5 + 免配送费 + 免打包费,实测净省 ¥1.10~¥12.10。`calculate-price` 会自动把 `521234 麦金卡体验卡(15天)` 和归零的配送/打包费写进 `productList`,**照抄返回值即可,不要自己拼价格**。
3. **周边

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
379
제작자
junxchan54-maker
라이선스
라이선스 명시 없음 이 repo에는 라이선스가 없습니다. 기본적으로 제작자가 모든 권리를 가지므로 배포나 상업적 사용 전에 문의하세요.
최근 코드 수정
2026년 10월 27일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
agent-skills, ai, ai-agent, automation, claude, claude-code, coupon, curso, food-ordering, llm, mcd, mcdonalds