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

io.github.edbror由 GitHub 帳號 edbror 發布v0.2.0更新於 Oct 26, 2026

Vigencia REPSE (STPS) en vivo, cruzada con 38 listas: SAT, sanciones, inhabilitaciones, PEP.

已驗證Streamable HTTP可網頁執行安全與監控商業與電商

概覽

AI 產生的概覽

即時查詢墨西哥承包商在 STPS 的 REPSE 公開名錄登錄狀態，回傳有效性判定與獲授權活動。

可以做什麼
  • 依 RFC、受理編號或公司名稱核驗單一承包商，取得有效性判定與獲授權活動
  • 批次核驗供應商組合，回傳統計計數以及僅需處理的紀錄
  • 依公司名稱檢索公開承包商名錄
  • 查詢 STPS 來源入口網站的可用性與延遲
  • 提供有效、即將到期、已過期、無紀錄或無法判定等狀態
適用情境
適合採購、供應商建檔、盡職調查與應付帳款查核，在核准或付款前確認墨西哥專業服務承包商是否持有有效的 REPSE 登錄。
執行需求
遠端 MCP 端點，需要 OAuth 驗證。清單未宣告環境變數或請求標頭。伺服器即時查詢 STPS 公開入口網站，需要能連線至該來源的網路。
安裝前請注意
此工具僅供參考，不簽發官方證明，也不能取代在 STPS 入口網站的直接查核或法律判斷。名錄本身的欄位可能把已過期紀錄標示為已找到，應以計算出的有效性旗標為準，而非原始是否存在。與 STPS 無隸屬關係。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 REPSE — Padrón de la STPS (servicios especializados)，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.edbror%2Frepse-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "repse-padr-n-de-la-stps-servicios-especi": {
      "type": "http",
      "url": "https://repse.watr.mx/connect"
    }
  }
}

README

repse-mcp

MCP server para consultar el Padrón Público de Contratistas de Servicios Especializados u Obras Especializadas (REPSE) de la STPS, en vivo, desde cualquier cliente MCP (Claude Desktop, Claude Code, Cowork, apps propias).

Convierte una verificación manual —entrar al portal, capturar RFC por RFC, interpretar el resultado— en una capacidad programática de cumplimiento para compras, alta de proveedores, due diligence y cuentas por pagar.

Hermano de sat69-mcp (listas SAT 69/69-B). Se complementan: un proveedor con REPSE vigente que además es EFOS definitivo sigue siendo un "no".

Tools

ToolQué hace
verificar_repse(termino)RFC, folio o razón social → veredicto de vigencia + actividades autorizadas
verificar_lote(rfcs)Cartera de proveedores → conteos y sólo los que requieren acción
buscar_padron(texto)Búsqueda por razón social en el padrón
estado_fuente()Disponibilidad y latencia del portal de la STPS

Estados: VIGENTE · POR_VENCER (≤60 días, configurable) · VENCIDO · SIN_REGISTRO · INDETERMINADO. El booleano vigente es el que debe gobernar un bloqueo de alta o de pago.

Arquitectura: en vivo, sin índice

El portal de la STPS no requiere scraping de HTML. Su bundle JS llama a dos endpoints JSON públicos y sin autenticación:

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

buscar-padron es POST de Laravel: exige cookie de sesión + X-CSRF-TOKEN, que el cliente toma del <meta csrf-token> del home y renueva solo ante un 419.

Consecuencia: no hay base de datos, ni Turso, ni pipeline de ingesta, ni navegador headless. Cada consulta va en vivo al padrón, así que la frescura del dato es total y no hay índice que se quede viejo. Se paga con latencia (~1 s) en vez de infraestructura.

Para búsqueda masiva y ventanas de vencimiento existe el índice local (padron.py): SQLite+FTS5 reconstruido desde el xlsx público GET /padron-public-excel (~155k filas), rebuild-on-boot + cron diario. Ver SPEC.md §2.

La trampa del campo registro

buscar-padron devuelve registro: 1 para registros ya vencidos: significa "lo encontré en el padrón", no "está vigente". Verificado contra el portal el 2026-08-01: el RFC ASE100712TT2 regresa registro: 1 con fecha_vencimiento_registro: 2024-09-10.

Quien lea registro como vigencia aprueba proveedores vencidos. La vigencia se calcula aquí, contra la fecha de vencimiento (src/repse/risk.py, cubierto en tests/test_risk.py).

Uso local (stdio)

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

Registro en Claude Code (scope user, editando ~/.claude.json directamente):

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

Despliegue (Render)

render.yaml en la raíz. Runtime Python nativo, plan free, health check en /health, MCP en /connect, landing de venta en /.

Variables: MCP_API_KEY (bearer estático), AUTHKIT_DOMAIN + BASE_URL (OAuth WorkOS, opcional), REPSE_BASE_URL (override de fuente).

Aviso

Esta herramienta informa; no emite la constancia oficial ni sustituye la verificación directa en repse.stps.gob.mx ni el criterio legal. No afiliado a la STPS.

來源：README.md，提交 0ae31f9

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

2
  1. v0.2.0最新Oct 22, 2026
  2. v0.1.0Oct 22, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。