常见问题 (FAQ)

您删除、注销账号操作需向我们申请，且确保在申请之后的 7日内不存在服务调用，经我们确认删除、注销的账号不可恢复。

已认证为企业开发者的账号，注销需通过 support@weathercn.com 联系我们。

即使你使用相同的信息重新注册帐号，已经被删除的信息依然无法再获取。

当您违反《华风爱科开放API服务协议》，您的帐号将被冻结，此时您无法使用服务。

为保护用户隐私安全，当用户连续12个月(1)未登录本平台，且(2)未使用服务时，该帐号被标记为闲置帐号并将在1个工作日内删除。

如果您提供的注册资料不准确，不真实，不合法，我们有权终止向您提供服务，并有权注销您的账户，因此产生的一切损失应由您自行承担。如您在使用过程中注册资料发生变更，您应当及时更新准确的、详细的注册资料。

登录后，在"账户设置"页面可以修改您的基本信息，包括开发者姓名、企业名称、手机号、邮箱等。请确保您的联系信息准确有效，以便我们在必要时与您联系。

在登录页面点击"忘记密码"，输入您注册时使用的手机号码，我们会发送验证码到您的手机，通过验证后即可重置密码。

此设计是为了减少逐日与逐小时预报返回的数据量。

除了某些参数之外，单位符号也将跟随预报数据里一并返回。所以 API 如果同时在预报数据反馈公制与英制单位的信息将需要复制大量的参数数据 - 此方法不符合大部分开发者的开发与使用逻辑。

为了减少数据量使用以及给予开发者更多的选择性，以及方便只使用一个单位的用户，公制与英制单位在接口里分开返回。

请首先检查您的 apikey 是否正确，配额是否充足。如果问题仍然存在，请查看错误代码和错误信息，参考开发标准与合规中的 Minutecast 容错说明。

API 分为多个数据接口，不同的接口有不同的授权权限。

如果您的 apikey 未得到当前所请求的数据接口权限，系统将会返回"unauthorized"信息提示，即表示当前 apikey 未获得该接口访问权限。

优先支持所有地点所在地的母语（如北京市母语为中文），然后在可支持的情况下增加该地点非母语的语言支持（如北京市支持英文）。

如有语言不支持某些地点说明该地点目前未支持该语言。

中文系语言默认支持简体中文（zh-cn），其他语系不支持的语言默认返回英文（en-us）。

我们不建议在任何情况下写入任何固定信息，例如城市 key、移动端网站链接、PC 端网站链接或其他数据。

我们推荐使用 API 以优化用户体验，旧有信息如 Location key 等也不断地在优化以及更新（例如行政区域规划后某城市规划新的城区）。

如果在程序里写入固定 Location key，这将导致程序里的固定 key 无法与更新后的 key 对接而造成数据无法请求。所以为了避免信息更新后出现无法获取数据的情况，请勿在程序中写入固定的城市清单或链接等信息。

部分气象站点不支持提供气候数据。

登录后，在"流量分析"页面可以查看详细的 API 调用统计，包括每日调用次数、成功率、响应时间等数据。

当您的 API 调用次数超出配额限制后，后续请求将返回配额超限错误。

如果您想继续使用，请联系商务购买配额或等待配额重置（每日0点重置）。

天气 MCP（Model Context Protocol）是一个专为 AI 助手设计的气象数据服务，遵循 MCP 标准协议。

与直接调用 REST API 的区别在于：

• 使用方式不同：REST API 由开发者写代码调用；MCP 由 AI 助手（如 Claude、Cursor）自动识别意图并调用，无需手写 HTTP 请求。
• 面向对象不同：REST API 面向开发者构建应用；MCP 面向 AI 工具直接嵌入对话能力。
• 接入复杂度不同：MCP 只需配置一个 JSON 文件，AI 即可自动处理天气问答，无需开发业务逻辑。

不需要。天气 MCP 与标准 API 共用同一套 Key 体系：

• 标准版 MCP：直接使用您在"应用管理"中已有的 openAPI Key 即可，无需额外申请。
• 高阶版 MCP：需要 JV Key（含 API Key + Secret），请联系商务申请。

可以。将您在"应用管理"页面看到的 openAPI Key 填入 MCP 配置文件的 WEATHERCN_OPENAPI_KEY 环境变量中即可使用。

标准版 openAPI Key 支持 8 个核心 Tool，实名认证后开通 30 天试用，每日配额 500 PV，QPS 5 次/秒。

主要差异如下：

• 预报时效：标准版逐日最长 10 天、逐小时最长 72 小时；高阶版逐日最长 90 天、逐小时最长 360 小时。
• 专项能力：高阶版额外支持台风路径、天文（日出日落/月相）、潮汐数据。
• 分钟降水覆盖：标准版仅中国区域；高阶版全球覆盖。
• 空气质量：标准版仅当前实况；高阶版含逐小时预报（24h）及全国城市排名。

凡是支持 MCP 协议的客户端均可接入，包括但不限于：

• Claude Desktop（Anthropic 官方桌面应用）
• Cursor（AI 代码编辑器）
• 其他支持 MCP stdio 协议的 AI 工具

具体配置方法请参考 天气 MCP 产品页 的快速接入章节。

步骤如下：

1. 安装：pip install weatherwork-consumer-mcp
2. 编辑 Claude Desktop 配置文件 claude_desktop_config.json，添加以下内容：

   {
     "mcpServers": {
       "weatherwork": {
         "command": "weatherwork-consumer-mcp",
         "env": {
           "WEATHERCN_OPENAPI_KEY": "your_openapi_key"
         }
       }
     }
   }

3. 重启 Claude Desktop，即可直接向 Claude 询问天气问题。

更多配置示例请查看 MCP 配置参考。

请按以下步骤排查：

1. 确认环境变量名称正确：标准版使用 WEATHERCN_OPENAPI_KEY，高阶版使用 WEATHERCN_API_KEY 和 WEATHERCN_API_SECRET。
2. 确认 Key 值完整复制，没有多余空格或换行。
3. 确认账户已完成实名认证（未认证的账户 Key 不具备调用权限）。
4. 确认 Key 未过有效期，可在"应用管理"页面查看有效期状态。

如仍无法解决，请联系 support@weathercn.com。

是的。MCP 底层调用的是同一套 weathercn API，使用的是同一个 openAPI Key，因此 MCP 调用量和直接调用 REST API 的调用量共享每日 PV 配额（实名认证后 30 天试用，500 次/天，5 QPS）。

如需更高配额，请联系商务申请高阶版或扩容方案。