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.

已验证Streamable HTTP可网页运行金融数据与分析商业与电商

概览

AI 生成的概览

将墨西哥 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 选择的模型服务商。
安装前请注意
结果仅反映 SAT 公开文件最近一次导入的情况,明确不构成税务或法律建议。刷新工具会下载并替换本地数据集,README 说明该替换是破坏性的,仅靠新鲜度校验保护。自建需要 MCP_API_KEY、TURSO_AUTH_TOKEN 及模型服务商凭据等密钥;组合摘要会把已判定的结果发送给第三方模型服务商。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SAT69 — Listas negras del SAT (69, 69-B, 69-B Bis y CSD),将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

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

ToolQué hace
verificar_rfcVerifica un RFC → veredicto de riesgo (CRITICO…LIMPIO, o NO_VERIFICADO si alguna lista está sin datos).
verificar_loteValida hasta 500 RFCs; devuelve sólo hallazgos por severidad.
buscar_nombreBúsqueda por nombre/razón social (FTS5, insensible a acentos).
estado_datosVigencia declarada por el SAT, conteos y última importación.
actualizar_datosDescarga + sincroniza los listados (idempotente por hash, con guard de frescura).
resumen_carteraBrief ejecutivo en lenguaje natural de una cartera (hasta 500 RFCs).

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

CSV del SAT (Latin-1)                     ┌────────── FastMCP ──────────┐   │  fetcher (httpx + proxy opcional)    │ verificar_rfc / _lote        │   ▼                                      │ buscar_nombre / estado_datos │ pipeline (parse 69 / 69b)  ──►  SQLite ──┤ actualizar_datos             │   │   (FTS5 unicode61, triggers)  ▲  │   └──────────┬──────────────────┘   ▼                               │  │   stdio (server.py) + HTTP (web.py) Turso (libSQL, durable) ◄── push  │  └► pull al arranque      │                                   └─────────────────── /health /refresh /reload
  • server.py — FastMCP (stdio) + tools + AuthKit.
  • web.py — Starlette/uvicorn (HTTP): /health (abierto), /refresh y /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

bash
cd sat69-mcppython -m venv .venv && source .venv/bin/activatepip install -e ".[dev]"
# Primera ingesta (descarga ~22 MB; el 69 son ~½ millón de filas)python -c "from sat69 import database as db, config; db.init_db(config.settings.db_path)"python -c "from sat69.pipeline import process_import; print(process_import())"
# Probarpytest -q

Conectar en Claude Desktop / Cowork (stdio)

json
{  "mcpServers": {    "sat69": { "command": "sat69-mcp" }  }}

(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):

  1. Sube el repo a GitHub y crea un Blueprint en Render apuntando a render.yaml.
  2. Variables (marcadas sync:false): MCP_API_KEY (bearer), opcional AUTHKIT_DOMAIN+BASE_URL (OAuth), TURSO_DATABASE_URL+TURSO_AUTH_TOKEN.
  3. 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_URL y /mcp pasa 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 en config.py.

来源:README.md,提交 63b3102

工具

0
该服务器需要登录,因此 SourceWeft 无法在没有账号的情况下读取其工具,也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

2
  1. v1.1.0最新Oct 12, 2026
  2. v1.0.0Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。