REPSE — Padrón de la STPS (servicios especializados)

repse-mcp

用于从任何 MCP 客户端（Claude Desktop、Claude Code、Cowork、自有应用）实时查询 STPS 的 专业服务或专业工程承包商公共名录（REPSE） 的 MCP 服务。

将手动核验——进入门户、逐个录入 RFC、解读结果——转变为采购、供应商准入、尽职调查和应付账款的合规编程能力。

与 sat69-mcp（SAT 69/69-B 名单）相辅相成。两者互为补充：REPSE 状态有效的供应商，如果同时属于最终认定的 EFOS，仍然不能通过。

工具

工具	功能
verificar_repse(termino)	RFC、编号或法定名称 → 有效状态判定 + 授权活动
verificar_lote(rfcs)	供应商名单 → 统计结果和仅需要采取行动的项目
buscar_padron(texto)	按法定名称搜索名录
estado_fuente()	STPS 门户的可用性和延迟

状态：VIGENTE · POR_VENCER（≤60 天，可配置）· VENCIDO · SIN_REGISTRO · INDETERMINADO。 布尔值 vigente 应作为是否阻止供应商准入或付款的判定依据。

架构：实时查询，无索引

STPS 门户不需要抓取 HTML。它的 JS bundle 会调用两个公开且无需身份验证的 JSON 端点：

GET  /busca_razon_social?term=…          → [{id, text}]   (RFC, folio o razón social)
POST /buscar-padron   razon_social=<id>  → detalle + actividades autorizadas

buscar-padron 是 Laravel 的 POST 请求：需要会话 cookie 和 X-CSRF-TOKEN。客户端从主页的 <meta csrf-token> 获取令牌，并且仅在收到 419 时才刷新。

因此：没有数据库、没有 Turso、没有数据摄取流水线，也没有无头浏览器。 每次查询都会实时访问名录，因此数据始终最新，也没有会过时的索引。代价是延迟（约 1 秒），而非基础设施。

如需大规模搜索和到期时间窗口，可使用本地索引（padron.py）：基于公开的 xlsx 文件 GET /padron-public-excel（约 155k 行）重建 SQLite+FTS5；启动时重建 + 每日 cron。参见 SPEC.md §2。

registro 字段的陷阱

buscar-padron 对已过期的记录也会返回 registro: 1：它表示“我在名录中找到了该记录”，而不是“该记录有效”。已于 2026-08-01 对照门户核验：RFC ASE100712TT2 返回 registro: 1，且 fecha_vencimiento_registro: 2024-09-10。

如果将 registro 视为有效状态，就会批准已过期的供应商。这里会根据到期日计算有效状态（src/repse/risk.py，由 tests/test_risk.py 覆盖）。

本地使用（stdio）

python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/repse-mcp          # stdio
.venv/bin/pytest -q          # tests

在 Claude Code 中注册（用户级别，直接编辑 ~/.claude.json）：

"repse": {
  "command": "/Users/ed/mcp-servers/repse-mcp/.venv/bin/repse-mcp"
}

部署（Render）

根目录下的 render.yaml。原生 Python 运行时，免费套餐，健康检查路径为 /health，MCP 路径为 /connect，销售落地页路径为 /。

变量：MCP_API_KEY（静态 bearer 密钥）、AUTHKIT_DOMAIN + BASE_URL（WorkOS OAuth，可选）、REPSE_BASE_URL（数据源覆盖项）。

免责声明

此工具仅提供信息；不会签发官方证明，也不能替代在 repse.stps.gob.mx 上直接核验或法律判断。与 STPS 无关联。