pontofato

PontoFato — 面向 AI Agent 的技能和 MCP 服务

PontoFato 可让 AI Agent 查找巴西地址及其周边的公司。输入邮政编码（CEP），即可获取对应地址及 IBGE 2022 年人口普查（CNEFE）的坐标、每栋建筑所在普查区的数据，以及在该处注册的公司。Agent 还可以搜索街道、查找离某个地点最近的地址，并统计 2 km 范围内某个行业的公司数量。本仓库为 Claude Code、Codex、Cursor 及其他 Agent 打包了 PontoFato 技能，以及连接到其远程 MCP 服务的功能。

网站： https://pontofato.com · MCP 服务： https://pontofato.com/mcp?checkout=site · 价格： https://pontofato.com/pricing · API 文档： https://pontofato.com/developers

你的 Agent 可以做什么

• 查询 CEP：获取地址、纬度和经度，以及每栋建筑所在普查区的数据（人口、住房和收入）。
• 按名称搜索街道，可限定州或城市，并列出建筑内的单位（公寓、商铺）。
• 查找离某个坐标最近的地址，并列出半径最多 2 km 范围内的 CEP。
• 列出在某个 CEP 注册的公司。
• 统计某个地点周边某项行业活动（CNAE）的活跃、开业和关闭公司数量，并查看最新开业的公司。

试试：“过去几个月，CEP 01310-100 附近开了哪些餐厅？” 或 “查找 Avenida Paulista, 1000, São Paulo 的坐标。”

安装

将 Claude Code 安装为包含技能和 MCP 服务的插件：

/plugin marketplace add wrpbr/pontofato
/plugin install pontofato@pontofato

适用于任何可读取 Agent Skills 的 Agent（Claude Code、Codex、Cursor、OpenCode 等）：

npx skills add wrpbr/pontofato

仅安装 MCP 服务（远程、Streamable HTTP，免费工具无需密钥）：

claude mcp add --transport http pontofato 'https://pontofato.com/mcp?checkout=site'   # Claude Code
codex mcp add pontofato --url 'https://pontofato.com/mcp?checkout=site'               # Codex

{ "mcpServers": { "pontofato": { "url": "https://pontofato.com/mcp?checkout=site" } } }

上面的 JSON 应放在 Cursor 的 .cursor/mcp.json 中，以及大多数其他客户端的 MCP 设置中。在 Claude.ai 和 Claude Desktop 中，打开“设置”→“连接器”→“添加自定义连接器”，然后粘贴服务地址。

价格

CEP 查询、街道搜索、最近地址查询、半径查询和 CEP 公司查询均免费且无需密钥。某个地点周边的公司数量查询（vizinhanca）有独立的免费额度；API 索引会说明何时免费。完整的 CNPJ 和地址核查每天都有免费额度；用完后，核查将使用套餐包或订阅方案。你可以在网站购买订阅方案和预付额度，订阅方案不会自动续订。插件不会代为付款：使用 checkout=site 时，MCP 服务没有购买工具，也没有付款参数。Agent 会显示价格和链接；购买后，它会使用你的额度令牌。当前价格见 https://pontofato.com/pricing。

插件会发送什么

该技能会指示 Agent 调用 pontofato.com 上的 PontoFato API。MCP 服务也运行在 pontofato.com 上。你的查询内容（CEP、街道名称、坐标和行业代码）会通过 HTTPS 发送到 pontofato.com。只有你为付费调用提供额度令牌时，令牌才会随请求发送。插件不会运行本地程序，也不会读取本地文件。

数据和限制

地址来自 IBGE 2022 年人口普查的 CNEFE 数据。这些数据不能证明 CEP 或地址目前有效。公司数据来自 Receita Federal 公开的 CNPJ 数据集，并按 CEP 与地址匹配，因此公司距离是 CEP 之间的距离，而非与具体建筑之间的距离。

葡萄牙语简介

PontoFato 可让 AI Agent 查找巴西地址及其周边的公司。输入 CEP，即可获取地址、IBGE 的坐标（CNEFE 2022）、每栋建筑所在普查区的人口普查数据，以及在该处注册的公司。Agent 还可以搜索街道、查找离某个地点最近的地址，并统计半径最多 2 km 范围内某个行业的公司数量。本仓库提供该技能以及连接到远程 MCP 服务的功能。使用上面的命令即可安装。CEP 查询免费且无需密钥。购买始终在网站上进行，插件不会自行付款。价格见 https://pontofato.com/pricing。

文件

文件	内容
skills/pontofato/SKILL.md	技能：哪个工具回答哪个问题、数据的限制，以及付费调用的规则
.mcp.json	插件的远程 MCP 服务
.claude-plugin/plugin.json	插件清单
.claude-plugin/marketplace.json	允许 Claude Code 将此仓库添加为插件市场
server.json	官方 MCP 注册表（com.pontofato/pontofato）中的清单
glama.json	Glama MCP 目录的维护者

许可证与联系

本仓库中的文件遵循 MIT-0 许可证。PontoFato 服务及其数据不属于此许可证的范围：其使用遵循使用条款和隐私政策。如有问题，请在此处提交 issue，或写信至 [email protected]。