Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

mcd-cn-assistant Skill

Repository ↗

von junxchan54-maker★ 3791 Skills

Installieren

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 Programmieren
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![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)

Zusammen nutzen mit

MCP-Server, die die KI für dieselbe Arbeit mit Diensten verbinden

REA

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

von morlutoWeit verbreitet↓ 388.706/Wo.★ 464.078Aktualisiert vor 6 Tagen

MCP · Verbindet einen DienstLäuft auf deinem Computer

Fallow

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

von fallow-rsWeit verbreitet↓ 2,4 Mio./Wo.★ 5379Aktualisiert gestern

MCP · Verbindet einen DienstLäuft auf deinem Computer

Desktop Commander

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

von wonderwhy-erWeit verbreitet↓ 740.317/Wo.★ 10.336Aktualisiert vor 6 Tagen

MCP · Verbindet einen DienstLäuft auf deinem Computer

Ähnliche Skills

Gleiche Art Arbeit, sortiert wie die Skill-Liste

Im Vergleich mit ähnlichen
Dieser
mcd-cn-assistant
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
Anbieterjunxchan54-makermorlutomultica-aiGraphify-Labsharry0703
Skills11111
GitHub-Sterne379465.460233.910149.364144.149
Letzte Codeänderung27. Okt. 202617. Nov. 202620. Apr. 202617. Nov. 202617. Nov. 2026
Lizenz–MIT–Apache-2.0MIT

1 Skills (Anweisungssammlungen) von junxchan54-maker, die eine KI liest und befolgt · kein MCP-Server

Was einen Skill von MCP unterscheidet

MCP = die Hände

Verbindet die KI mit einem externen Dienst oder Daten, etwa Notion lesen oder eine Rechnung erstellen. Ein Programm oder Server muss laufen.

Skill = das Handbuch

Eine Textdatei, die der KI zeigt, wie eine Aufgabe geht. Sie verbindet sich mit nichts.

Manches überschneidet sich: Einige Skills starten Skripte mit Werkzeugen, einige MCP-Server liefern nur Wissen. Geh von der Aufgabe aus.

Funktioniert mit

Claude CodeCursorGitHub CopilotKiro

Laut README des Anbieters und den Ordnern im Repo

Installieren

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 27. Okt. 2026

  • 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

Zuerst: Welche KI nutzt du?

Wähle deine App, dann zeigt diese Seite nur die Installation für diese App

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 12. Nov. 2026 · Source: support.claude.com, support.claude.com, code.claude.com

Option 1Claude Code installieren lassen

Kopiere diesen Satz und füge ihn in einen Claude Code-Chat ein

Where to install

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

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 neu starten, dann /mcd-cn-assistant tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill

Checked against official docs 12. Nov. 2026 · Source: code.claude.com

For Terminal users

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.claude/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

  3. Claude Code neu starten, dann /mcd-cn-assistant tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill

Selbst installierte Skills funktionieren in der ChatGPT-Desktop-App, in Codex CLI und in der Codex-Erweiterung für die IDE · ChatGPT im Web und auf dem Handy kann selbst installierte Skills nicht nutzen, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen

ChatGPT-Desktop-App

Die ChatGPT-Desktop-App enthält Codex, und Codex liest Skills aus dem Ordner ~/.agents/skills

Option 1ChatGPT installieren lassen

Öffne Codex in der ChatGPT-Desktop-App und füge diesen Satz in den Chat ein

Where to install

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

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 2Ordner selbst ablegen

Lege den Ordner mcd-cn-assistant unter ~/.agents/skills/mcd-cn-assistant ab

~ ist dein Home-Ordner ($HOME)

For Terminal users

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.agents/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Nach der Installation

  • ChatGPT-Desktop-App: Öffne Skills in der Seitenleiste, um zu sehen, ob der Skill da ist
  • So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
  • Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu

Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com

ChatGPT im Web und auf dem Handy

Selbst installierte Skills funktionieren hier nicht, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen

Um diesen Skill mit ChatGPT zu nutzen, verwende die ChatGPT-Desktop-App wie oben beschrieben

Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com

Option 1Codex installieren lassen

Kopiere diesen Satz und füge ihn in einen Codex-Chat ein · Funktioniert in Codex in der ChatGPT-Desktop-App, in Codex CLI und in der IDE-Erweiterung

Where to install

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

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 erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu · So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen

Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com

For Terminal users

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.agents/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

  3. Codex neu starten und eine passende Aufgabe stellen; Codex listet den Skill

Option 1Cursor installieren lassen

Kopiere diesen Satz und füge ihn in einen Cursor-Chat ein

Where to install

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

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

Im Agent-Chat von Cursor / tippen und mcd-cn-assistant wählen

Checked against official docs 12. Nov. 2026 · Source: cursor.com

For Terminal users

Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.

  1. Terminal öffnen

    Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“

  2. Skill-Ordner nach ~/.cursor/skills kopieren

    Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md

    Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

  3. Im Agent-Chat von Cursor / tippen und mcd-cn-assistant wählen

Option 1Let the AI install it

Für andere Apps, die Skills lesen. Der Satz enthält die Pfade für Claude Code, Codex und Cursor, damit die KI den für deine App wählt · Copy this sentence into the app’s chat

Where to install

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind

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 12. Nov. 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Andere Apps mit Agent Skills (etwa Gemini CLI oder GitHub Copilot) nutzen andere Ordner. Sieh in deren Anleitung nach und kopiere den Ordner mit der SKILL.md dorthin.

Auf GitHub ansehen ↗

Skill-Ordner am 11. Nov. 2026 mit den offiziellen Anleitungen von Claude Code, Codex und Cursor geprüft

Original-SKILL.md ansehen

Der folgende Text stammt aus dem Repo des Anbieters, nicht von PopNx MCP

Die ersten 8.000 Zeichen · Ganze Datei auf GitHub öffnen

---
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. **周边

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Von GitHub

GitHub-Sterne
379
Anbieter
junxchan54-maker
Lizenz
Keine Lizenz angegeben Dieses Repo nennt keine Lizenz: Standardmäßig behält der Autor alle Rechte. Frag vor Weitergabe oder kommerzieller Nutzung nach.
Letzte Codeänderung
27. Okt. 2026
SKILL.md-Dateien im Repo (mit Übersetzungen und Vorlagen)
1
Themen
agent-skills, ai, ai-agent, automation, claude, claude-code, coupon, curso, food-ordering, llm, mcd, mcdonalds