
SAT69 — Listas negras del SAT (69, 69-B, 69-B Bis y CSD)
io.github.edbror由 GitHub 帳號 edbror 發布v1.1.0更新於 Nov 2, 2026
Verifica RFCs contra las listas del SAT (69, 69-B EFOS, 69-B Bis, CSD): veredicto de riesgo fiscal.
概覽
將墨西哥 RFC 稅號比對 SAT 公開的 69、69-B(EFOS)、69-B Bis 與 CSD 名單,給出稅務風險判定。
- 可以做什麼
- 核驗單一 RFC,回傳從 CRITICO 到 LIMPIO 的風險判定,名單缺資料時為 NO_VERIFICADO
- 批次校驗最多 500 個 RFC,僅依嚴重程度回傳命中項目
- 依姓名或公司名稱進行不區分重音符號的全文檢索
- 查詢資料狀態:SAT 宣告的有效期間、筆數與最近一次匯入時間
- 下載並同步 SAT 名單檔案以更新資料
- 為最多 500 個 RFC 的投資組合產生自然語言執行摘要
- 適用情境
- 適合稅務、法遵、採購或應付帳款情境:讓助理篩查供應商或客戶組合是否列於墨西哥 SAT 黑名單,並彙整稅務風險。也適合在開立發票或供應商建檔前批次核查 RFC 清單。
- 執行需求
- 遠端端點,要求 OAuth 驗證;README 另述本機 Python 安裝(pip、FastMCP)以 stdio 執行。自架需 MCP_API_KEY 作為 bearer 驗證,可選 AUTHKIT_DOMAIN 與 BASE_URL 啟用 OAuth,以及 TURSO_DATABASE_URL 與 TURSO_AUTH_TOKEN 作為持久儲存;可選 FETCH_PROXY 用於 CSV 下載。組合摘要使用可透過 LLM_PROVIDER 選擇的模型供應商。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 SAT69 — Listas negras del SAT (69, 69-B, 69-B Bis y CSD),將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
交給代理程式安裝
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.edbror%2Fsat69-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"sat69-listas-negras-del-sat-69-69-b-69-b": {
"type": "http",
"url": "https://sat69.watr.mx/connect"
}
}
}README
MCP SAT 69 / 69-B · WATR
Servidor MCP (Model Context Protocol) en Python / FastMCP para consultar las listas públicas del SAT:
- Artículo 69-B del CFF (EFOS) — operaciones simuladas: Presunto, Desvirtuado, Definitivo, Sentencia Favorable.
- Artículo 69-B Bis del CFF — transmisión indebida del derecho a disminuir pérdidas fiscales: Definitivo, Sentencia Favorable. Es señal de riesgo del contribuyente, pero no invalida sus CFDI por sí sola. Lista diminuta: 3 registros en todo el país (sep-2026), así que un conteo de un dígito es correcto, no una importación fallida.
- Artículo 69 del CFF — situación fiscal firme: firmes, exigibles, no localizados, cancelados, condonados.
Misma arquitectura que el MCP de movilizaciones de la SSC-CDMX: FastMCP con transporte stdio + Streamable HTTP, OAuth 2.1 (WorkOS AuthKit) con fallback a bearer estático, persistencia en Turso (libSQL), proxy de descarga opcional, y despliegue en Render con cron externo (GitHub Actions). Sin OCR: los CSV del SAT ya vienen estructurados.
Tools
Prioridad de severidad entre listas: 69-B > 69-B Bis > 69.
⚠️ resumen_cartera es el único tool con IA, y sólo redacta. El riesgo de cada RFC lo calcula el motor de reglas (determinista); el modelo recibe esos veredictos ya resueltos y escribe el brief — nunca decide un riesgo ni cambia uno. Proveedor conmutable con LLM_PROVIDER (qwen por default vía DashScope; también anthropic y gemini). Sin IA configurada el tool igual responde: devuelve los datos deterministas con resumen: null.
Riesgo: CRITICO (EFOS definitivo) · ALTO (EFOS presunto) · MEDIO (69 firme/exigible/no localizado) · BAJO (desvirtuado/sentencia favorable) · INFORMATIVO (69 cancelado/condonado) · LIMPIO.
Los resultados reflejan la última importación de los archivos públicos del SAT. No constituyen asesoría fiscal ni legal.
Arquitectura
server.py— FastMCP (stdio) + tools + AuthKit.web.py— Starlette/uvicorn (HTTP):/health(abierto),/refreshy/reload(bearer M2M),/mcp(OAuth o bearer).pipeline.py— descarga → SHA-256 (omite si no cambió) → parse Latin-1 → guard de frescura → reemplazo en SQLite → push a Turso. El guard aborta el reemplazo si el archivo nuevo trae 0 filas habiendo datos, pierde más del 10% de las filas previas, o declara una fecha del SAT anterior a la ya importada: el reemplazo es destructivo y la fuente es de un tercero. El piso es relativo, no un mínimo absoluto, porque conviven listas de 243k filas y de 3.database.py— SQLite + FTS5 con triggers; RFC por índice B-tree (camino caliente).turso.py— sync durable Turso ↔ local.risk.py— normalización de RFC + árbol de veredicto (69-B manda sobre 69).
Instalación local
Conectar en Claude Desktop / Cowork (stdio)
(o "command": "python", "args": ["-m", "sat69"] con el venv activo.)
Despliegue en Render
render.yaml provisiona el servicio web con runtime Python nativo (sin Docker):
- Sube el repo a GitHub y crea un Blueprint en Render apuntando a
render.yaml. - Variables (marcadas
sync:false):MCP_API_KEY(bearer), opcionalAUTHKIT_DOMAIN+BASE_URL(OAuth),TURSO_DATABASE_URL+TURSO_AUTH_TOKEN. - Endpoint MCP:
POST https://<servicio>.onrender.com/mcp.
Auth (dos modos, igual que movilizaciones)
- Bearer estático (
MCP_API_KEY): simple, protege/mcp,/refresh,/reload. - OAuth 2.1 (WorkOS AuthKit): define
AUTHKIT_DOMAIN+BASE_URLy/mcppasa a OAuth con Dynamic Client Registration; el bearer sigue protegiendo los endpoints M2M.
Refresco automático
.github/workflows/refresh.yml hace POST /refresh diario (11:30 UTC ≈ 05:30 CDMX). Secrets del repo: RENDER_BASE_URL, MCP_API_KEY. Manual: workflow_dispatch (con force).
Persistencia (Turso)
SQLite local (efímero en Render, /tmp) atiende las consultas; Turso es el almacén durable que sobrevive redeploys. Al arrancar se hace pull de Turso; tras cada actualizar_datos//refresh se hace push. Sin TURSO_*, corre en modo local puro.
Proxy de descarga (opcional)
FETCH_PROXY o DATAIMPULSE_* enrutan sólo la descarga de los CSV. En pruebas el SAT no bloqueó IPs de datacenter (descargas 200 directas), así que normalmente no hace falta; se conserva por paridad y resiliencia.
Fuentes de datos (SAT · Datos Abiertos)
- 69-B:
Listado_Completo_69-B.csv(~14 k registros, 20 columnas, header en línea 3). - 69:
Firmes.csv,Cancelados.csv,NoLocalizados.csv,Exigibles.csv,Sentencias.csv,Condonados.csv(~½ millón de registros, 6 columnas). URLs enconfig.py.
來源:README.md,提交 63b3102
工具
0版本歷史
2- v1.1.0最新Oct 12, 2026
- v1.0.0Sep 16, 2026
評分
已滿足適用檢查項的 75%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
請在儲存庫或註冊中心條目中宣告授權條款。