name mentionkit

description 查询并管理 Mentionkit 社交监控工作流。当用户希望查看品牌提及、发现可回复的互动机会、筛选潜在客户线索对话、检查来源链接或在 Mentionkit 中创建跟踪关键词时使用。

优先使用 Mentionkit MCP 服务器；若不可用，则使用 Mentionkit 公共 API v1 进行有限的只读脚本编写和基础数据访问。

license MIT

metadata author version

mentionkit

0.1.0

compatibility 需要具备 Mentionkit 工作区访问权限，且支持 MCP 或 API 访问。MCP 需要兼容 MCP 的代理；API v1 需要网络连接和 Mentionkit API 密钥。

Mentionkit

Mentionkit 是一款社交监控工具。一个工作区可追踪项目与关键词，跨平台收集匹配的提及内容，对相关内容进行相关性评分，并帮助运营人员审查、验证和回应最具价值的对话。Mentionkit MCP 基于“上下文优先”的工作流设计：首先加载工作流上下文，其次筛选优质提及，最后在做出最终判断前检查来源链接。

与 Mentionkit 有两种交互方式。优先使用 MCP 服务器以支持交互式代理工作流。在无法使用 MCP 的环境中，可退而使用公共 API v1 来实现脚本化操作、基础提及访问、组织/项目/关键词读取以及简单的提及操作。

决策：MCP 还是 API v1？

• MCP — 适用于交互式代理任务、审查工作流、潜在客户线索工作流、回复机会审查及关键词创建。
• API v1 — 适用于 shell 脚本、数据导出、简单提及浏览、项目/关键词/组织信息读取、提及状态更新，以及在 MCP 不可用时生成评论请求。

若 Mentionkit MCP 工具已连接，请直接使用，无需重复配置。

* * *

选项 A：MCP（推荐）

使用 Mentionkit 工作区设置中显示的完整 MCP 服务器地址。

连接成功后，服务器将提供自身指令，所有工具均自带描述。当前 Mentionkit 可用工具包括：

• mentionkit_opportunities_context
• mentionkit_find_opportunities
• mentionkit_mentions_context
• mentionkit_list_mentions_raw
• mentionkit_fetch_url
• mentionkit_create_keyword（仅写入权限）

请仔细阅读工具说明，切勿猜测参数。

MCP 工作流规则

• 在调用 mentionkit_find_opportunities 之前，必须先调用 mentionkit_opportunities_context。
• 在调用 mentionkit_list_mentions_raw 之前，必须先调用 mentionkit_mentions_context。
• 在从 mentionkit_find_opportunities 获取短名单后，再使用 mentionkit_fetch_url 获取对应链接。
• 审查工作流中，优先使用 mentionkit_find_opportunities，而非直接列出原始提及。
• 保持 Mentionkit 相关性评分在 1-5 分制范围内。
• 若 mentionkit_fetch_url 失败，应降低置信度，而非将该提及视为已验证。

MCP 注意事项

• mentionkit_create_keyword 会修改实时工作区。切勿自行虚构项目值、平台设置、子版块列表、禁用词或分类器提示语。
• mentionkit_find_opportunities 需明确指定项目。在单个审查流程中不得混合多个项目。
• mentionkit_list_mentions_raw 使用 nextCursor 实现分页，且游标为 ID 基础。需原样传回下一页。
• mentionkit_fetch_url 即使获取失败，也会返回成功封装结果。请检查 fetchStatus 字段后再决定是否视为有效。
• mentionkit_create_keyword 仅在令牌具有 mcp:write 权限时才可见。

* * *

选项 B：API v1

在 MCP 不可用或需要脚本化操作时使用。

基础 URL：https://api.mentionkit.com

OpenAPI 文档：https://api.mentionkit.com/openapi.json

YAML 定义文件：https://api.mentionkit.com/openapi.yaml

Mentionkit API v1 是一个功能较窄的公开数据接口，不提供与 MCP 相同的以工作流为核心的上下文工具。

认证方式

使用 Mentionkit API 密钥作为 Bearer Token，置于 Authorization 请求头中。

curl "https://api.mentionkit.com/api/v1/projects" \
  -H "Authorization: Bearer $MENTIONKIT_API_KEY"

稳定的公开端点

• GET /api/v1/mentions
• POST /api/v1/mentions/:id
• PUT /api/v1/mentions/:id/comment
• GET /api/v1/keywords
• GET /api/v1/projects
• GET /api/v1/me

建议使用 API v1 实现以下功能：

• 基础提及内容获取
• 项目与关键词列表查询
• 组织概览与使用情况读取
• 提及审查状态更新
• 生成评论请求

请勿将 API v1 视为以下功能的替代方案：

• mentionkit_opportunities_context
• mentionkit_find_opportunities
• mentionkit_mentions_context
• mentionkit_fetch_url

API v1 注意事项

• 公开文档中提及的查询参数仍使用原始名称：platform、keywords、startdate、enddate。
• 分页使用 nextCursor，下一页请求需原样传回该值。
• API v1 仅用于直接数据访问，不包含 MCP 的工作流引导或上下文工具。
• 当前公开文档表面未暴露公共关键词创建功能。

工作流

1. 判断使用 MCP 或 API v1。若 Mentionkit MCP 工具已连接，优先使用。
2. 对于 MCP 审查工作流，首先加载匹配上下文工具。
3. 对于机会审查，使用 mentionkit_find_opportunities 筛选，然后在做出最终判断前获取保留的链接。
4. 对于原始浏览，先调用 mentionkit_mentions_context，再按需使用 mentionkit_list_mentions_raw 分页获取。
5. 对于 API v1，构建最小化请求以回答问题，仅在用户需要多页数据时才进行分页。
6. 总结信号与置信度水平。不要直接输出提及行列表。