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

repse-mcp

STPS の**専門サービスまたは専門工事請負業者公開登録簿（REPSE）**を、任意の MCP クライアント（Claude Desktop、Claude Code、Cowork、自社アプリ）からリアルタイムで照会する 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 バンドルは、認証不要の公開 JSON エンドポイント 2 つを呼び出します。

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（約 15 万 5 千行）から 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 とは提携していません。