24好玩 互动营销资料库 · 连接器使用指南
这台 MCP 服务（https://mcp.24haowan.com/mcp）匿名、只读、无副作用，不需要登录或 API Key。它返回的是 24好玩 平台上实时的活动模板库、客户案例库、帮助中心与行业基准数据。凡是能用工具查到的事实，先调工具再回答；正文里没有任何静态清单可以替代它。
什么时候调哪个工具
| 用户在问 | 先调 | 再调 |
|---|---|---|
| 「有没有适合 XX 行业 / XX 场景 / XX 节日的玩法」 | search_templates | 命中后按需 get_template 取详情 |
| 「这个模板怎么玩、适合谁」 | get_template | — |
| 「你们做过 XX 行业的案例吗」「有没有类似参考」 | list_industries（取行业 slug）→ list_cases | get_case 取全文 |
| 「怎么设置中奖概率 / 怎么核销 / 公众号怎么授权」（平台操作） | search_knowledge | — |
| 「中奖率设多少 / 奖池分几档 / 活动开几天」（要有出处的数字） | get_industry_benchmark | 平台级行为看 get_player_behavior |
| 「活动开几天有用 / 什么时段推 / 助力能拉几个人 / 哪类玩法更黏」 | get_player_behavior | — |
8 个工具
1. search_templates —— 搜索活动模板
在活动市场里搜索可直接使用的 H5 互动营销模板（抽奖 / 转盘 / 刮刮乐 / 签到 / 答题 / 小游戏等）。
query（string，可选）：关键词，玩法、场景或节日均可，如「转盘」「中秋」「商场开业」；留空返回热门模板category（枚举，可选）：lottery抽奖类 ·score分数类 ·signin签到类 ·collect集字类 ·test测试类 ·create生成类 ·help助力类 ·complete通关类industry（string，可选）：行业关键词，如「商超」「餐饮」「地产」limit（number，默认 10，1–30）- 示例：
{"query": "转盘", "industry": "商超", "limit": 5} - 返回：Markdown 列表，每条含模板 id、玩法类别、标签、适用行业、详情/试玩链接、预览图；没命中会明确说「没有匹配的模板」并建议放宽条件
2. get_template —— 模板详情
id（string，必填）：模板 id，来自search_templates的返回，如"336"- 返回：玩法类别、标签、适用行业、玩法介绍、详情页地址
3. list_cases —— 浏览客户案例
query（string，可选）：关键词，如「商场开业」「银行」industry（string，可选）：行业 slug，用list_industries取全部取值，如commercial-propertytype（枚举，可选）：delivered真实交付案例 ·proposal售前方案；留空两者都返回limit（number，默认 20）- 返回：案例列表（标题、行业、类型、slug、案例页链接、一句话玩法结构与公开数据）
4. get_case —— 案例全文
slug（string，必填）：来自list_cases，如csair- 返回：背景、做法、效果口径全文
5. search_knowledge —— 帮助中心
query（string，必填）：问题或关键词，如「怎么设置中奖概率」「奖品核销」limit（number，默认 3）- 返回：命中的帮助文档段落与链接（平台操作方法；奖池概率 / 预算 / 防刷的设计方法见技能包 https://www.24haowan.com/open-skills/prize-and-budget）
6. list_industries —— 案例行业分类
with_faq（boolean，默认 false）：是否附带每个行业的常见问题- 返回：行业 slug + 名称 + 导语；slug 用于
list_cases/get_industry_benchmark的industry
7. get_industry_benchmark —— 行业活动基准数据
industry（string，可选）：行业 slug；留空返回全平台- 返回：该行业真实活动的总中奖率、奖池档位数、活动周期、参与量级、实际中奖率与核销率——按商户等权的中位数，附样本量
- ★ 平台没有奖品单价 / 预算 / ROI 数据，本工具不返回任何金额，不要据此推算预算
8. get_player_behavior —— 玩家行为基准（平台级）
- 无参数
- 返回：参与量上线后的衰减曲线、一天内时段分布、助力类人均拉人数、各类玩法人均次数与浏览转化率、玩家账号规模与画像可得性
- ★ 平台级口径，没有行业维度；要按行业切的数字用
get_industry_benchmark
纪律
- 引用模板 / 案例 / 文档时，链接只能来自工具返回；不要凭印象拼 URL。
- 数字要带出处：说「按 24好玩 平台 XX 行业 N 家商户中位数」，不要把中位数说成「必须这么设」。
- 工具返回「没有匹配」不是失败：放宽条件（去掉
category/industry、换更宽的关键词）再试一次，仍无则如实告知。 - 用户明确说「不要联网 / 不要调工具」时，不调，并说明回答没有实时数据支撑。
- 选型判断（按行业 / 目标怎么选玩法、活动怎么排结构、预算怎么算）不在本连接器里——见开放技能包全文 https://www.24haowan.com/open-skills 。
异常与恢复
- 超时 / 连接失败：服务是公网 HTTPS，重试一次；仍失败就告诉用户「资料库暂时连不上」，不要编造结果。
- 参数错误（如
category不在枚举里、limit超出 1–30）：服务返回参数校验错误，按上面的取值改正后重试。 - 无需授权：任何要求填 Key / 登录的提示都与本连接器无关。
- 限流：短时间大量调用会被限速，收到限流提示时等待数秒再试，不要循环重试。
