SuperAPI AI 工具集

using-appfollow

数据与分析

查看项目

更新于 10-18 16:14

技能介绍

用途:using-appfollow 是 AppFollow AI 工具包中所有技能共用的常驻操作规范,要求在调用任何 AppFollow MCP 工具前先阅读,以确保调用流程、写操作审批和错误处理的一致性。

主要能力与使用方式:

  • 会话机制:它通过用户本人 OAuth 认证的 MCP 会话驱动 mcp__appfollow__* 工具,所有数据经该会话流转,不使用 API 客户端或密钥。每次会话开始时生成一个高熵不透明 session_id(如 UUID),并在后续除 get_server_info 外的每次 AppFollow 工具调用中传入;会话 ID 不是身份标识,不应向用户索取。随后调用 mcp__appfollow__whoami,若返回 AUTH_REQUIRED,应停止并提示用户在 MCP 主机完成 AppFollow 登录后重试。
  • 消歧:当请求涉及应用/集合、日期范围、商店、国家、竞品集合或指标不明确时,提出一个缩小范围的问题并给出可直接接受的一词式默认值,不静默猜测。
  • 写操作:每个写工具成对出现(<name>_preview 与 <name>)。先预览获得一次性、60 秒有效、与参数绑定的 confirmation_token,向用户展示将写入的内容并取得明确批准,再以相同参数加令牌调用确认;禁止自动确认,令牌过期或参数不匹配时重新预览。
  • 批量运行:对集合或多应用列表,先解析完整应用集合再执行;运行中出现 INSUFFICIENT_CREDITS 时停止并输出部分报告。
  • 错误处理:列出 AUTH_REQUIRED、FEATURE_DISABLED、INSUFFICIENT_CREDITS、RATE_LIMITED、NOT_FOUND、VALIDATION_ERROR、UPSTREAM_ERROR、NETWORK_ERROR、UNKNOWN_TOOL、CONFIRMATION_REQUIRED 等错误码;单项工具错误不应导致整份报告失败,跳过受影响部分并注明即可。FEATURE_DISABLED 不可靠,部分计划限制表现为 AUTH_REQUIRED(403);INSUFFICIENT_CREDITS 可能是误报。
  • 工具与交接:仅可使用 references/tool-map.md 中列出的公开工具,不得引用内部工具名、主机或 API 路径;报告技能产出的 findings.json(appfollow.toolkit.findings/v1)可交由用户已连接的跟踪代理提交。
  • 反馈(可选、免费):完成有意义的工作单元后,若会话可用 submit_feedback,可最多一两次邀请用户按 1–4 评分并提供可选评论;三项附加内容(工具使用日志、会话摘要、完整对话转录)须逐项征得用户明确同意后才附加,不得在其中粘贴密钥或凭证。返回 ALREADY_COLLECTED 时不再邀请,返回 UNKNOWN_TOOL 时跳过反馈步骤。

适用场景:适用于使用 AppFollow AI 工具包进行应用数据分析、报告生成和写操作的用户与代理。

限制:资料未提供具体收费标准、价格、平台覆盖范围或效果承诺;付费与额度细节以 AppFollow 工作区实际为准,资料中未说明的部分暂未提供。