Veradata

🔍 试用在线演示 — 无需账户

VeraData — 面向自主 AI Agent 的经验证拉丁美洲数据

原生支持 M2M。x402 支付。无需账户。无需 API 密钥。拉丁美洲优先。

由 Intelica 和 TrustBoost 的创作者打造。

API： https://api.veradata.dev | 版本： v1.6.0 | 国家/地区： CO、MX、BR、CL、PE、AR

此仓库包含公开接口、MCP 服务定义和开发者套件。 核心 API 部署于 api.veradata.dev。

---

MCP 服务（模型上下文协议）

VeraData 在 提供原生 MCP 服务，兼容 Claude Desktop、Claude Code、Cursor、Windsurf、Smithery 和 Glama。

在 Claude Desktop 中连接

添加到 ：

{
  "mcpServers": {
    "veradata": {
      "url": "https://api.veradata.dev/mcp"
    }
  }
}

在 Claude Code 中连接

claude mcp add veradata --url https://api.veradata.dev/mcp

MCP 工具

工具	描述	价格
	实时 LATAM 中央银行利率（CO、MX、BR、CL、PE）	/bin/sh.02 USDC
	制裁筛查 — OFAC + SARLAFT + CNBV + COAF + UAF	/bin/sh.05 USDC
	从 RUES/CNPJ/RFC 登记处获取公司信息	/bin/sh.03 USDC
	AI 驱动的 LATAM 市场情报（Claude Haiku）	/bin/sh.10 USDC

MCP 协议

• 传输： HTTP（可流式 HTTP、JSON-RPC 2.0）
• 清单：
• 工具： 及
• 支付： 在 Base () 和 Solana 上进行 x402 微支付

工具定义位于 。

---

要解决的问题

截至 2026 年 6 月 28 日，Agentic Market 上有 1,357 项 x402 服务。美国和欧洲已有个人信息增强服务。OFAC 已有制裁筛查服务。BTC/ETH 已有金融信号服务。

拉丁美洲却一片空白。

没有 x402 服务涵盖：

• 哥伦比亚 NIT / DIAN 登记查询
• SARLAFT 制裁筛查（哥伦比亚金融机构必须执行）
• 巴西 CNPJ / Receita Federal 验证
• 墨西哥 RFC / SAT 状态
• LATAM 中央银行利率（DTF、TIIE、Selic）
• 针对 EU AI Act 第 13 条的区域合规验证

这是一个每天处理 120 万美元 Agent 交易的市场缺口。VeraData 填补了这一空白。

---

VeraData 是什么

一项包含 5 个端点的 FastAPI 服务，每次调用均可通过 Base 和 Solana 上的 x402 付费。纯 M2M — 无需人工交互。任何拥有钱包的 Agent 都可以通过 CDP Bazaar、Agentic Market 或 402 Index 发现该服务，以 USDC 付款，并立即收到结构化 JSON。

技术栈： FastAPI + Supabase + Render（与 Intelica/TrustBoost 相同 — 已在生产环境中验证）

支付： x402 v2，符合 CAIP-2（eip155:8453 + solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp）

分发： CDP Bazaar + Agentic Market + 402 Index（所有渠道均已通过 Intelica 验证）

---

5 个端点

1. POST /entity — LATAM 实体信息增强 — $0.03 USDC

给定公司名称和国家/地区，返回来自公共登记处的结构化实体数据。

// Request
{ "name": "Bancolombia", "country": "CO" }

// Response
{
  "nit": "890903938-8",
  "razon_social": "Bancolombia S.A.",
  "estado": "ACTIVA",
  "camara_comercio": "Bogotá",
  "fecha_constitucion": "1945-01-24",
  "representante_legal": "Juan Carlos Mora Uribe",
  "ciiu": "6412",
  "pep_check": false,
  "data_source": "RUES_CO",
  "verified_at": "2026-06-28T14:00:00Z"
}

数据来源： RUES（哥伦比亚）、Receita Federal（巴西）、SAT（墨西哥）、SRI（厄瓜多尔）、SBS（秘鲁）

价格： $0.03 — 每 24 小时刷新一次，缓存在 Supabase 中

---

2. POST /sanctions — 制裁与合规筛查 — $0.05 USDC

根据 LATAM 和全球制裁名单筛查实体或个人。返回风险评分和符合 EU AI Act 的审计哈希。

// Request
{ "name": "Juan García López", "country": "CO", "type": "person" }

// Response
{
  "risk_score": 0.02,
  "risk_category": "CLEAN",
  "lists_checked": ["OFAC_SDN", "SARLAFT_CO", "CNBV_MX", "COAF_BR", "UAF_CL"],
  "matches": [],
  "pep_status": false,
  "audit_hash": "sha256:abc123...",
  "compliance": ["EU_AI_ACT_ART13", "SARLAFT_2024", "FATF_R16"],
  "checked_at": "2026-06-28T14:00:01Z"
}

涵盖名单：

• 🇨🇴 SARLAFT（哥伦比亚）— 每日更新
• 🇲🇽 CNBV Lista Negra（墨西哥）
• 🇧🇷 COAF/BACEN（巴西）
• 🇨🇱 UAF（智利）
• 🌍 OFAC SDN（美国/全球）
• 🌍 联合国安全理事会综合名单
• 🌍 欧盟综合制裁名单

监管护城河： EU AI Act 第 13 条将于 2026 年 8 月 2 日 开始实施 — 任何在 LATAM 运营 AI Agent 的欧洲公司都需要此端点。

价格： $0.05 — 利润率最高的模块，金融科技企业必备

---

3. POST /registry — 企业注册信息查询 — $0.05 USDC

实时查询官方公共登记机构的企业注册数据。

// Request
{ "identifier": "890903938", "country": "CO", "id_type": "nit" }

// Response
{
  "identifier": "890903938-8",
  "razon_social": "Bancolombia S.A.",
  "tipo_empresa": "Sociedad Anónima",
  "estado_juridico": "ACTIVA",
  "fecha_registro": "1945-01-24",
  "domicilio": "Medellín, Antioquia, Colombia",
  "objeto_social": "Actividades de banca comercial",
  "capital_suscrito_cop": 1076956260000,
  "registro_mercantil": "890903938-8",
  "renovado_hasta": "2026-12-31",
  "fuente": "Cámara de Comercio de Medellín",
  "verified_at": "2026-06-28T14:00:02Z"
}

**国家：**哥伦比亚（RUES + Cámaras）、墨西哥（SAT + IMSS）、巴西（CNPJ / Receita Federal）、智利（SRCeI）、秘鲁（SUNARP/SUNAT）

价格：$0.05

---

4. POST /rates — LATAM 金融信号 — $0.02 USDC

实时获取 LATAM 各国央行的汇率和宏观指标。不使用 AI——提供原始数据、结构化 JSON，并缓存 5 分钟。

// Request
{ "country": "CO", "signals": ["usd_cop", "dtf", "ipc_monthly"] }

// Response
{
  "country": "CO",
  "timestamp": "2026-06-28T14:00:03Z",
  "usd_cop": 4187.35,
  "dtf_ea": 10.85,
  "ipc_monthly_pct": 0.47,
  "ipc_annual_pct": 6.12,
  "banrep_rate_pct": 9.75,
  "trm_official": 4187.35,
  "source": "Banco de la República de Colombia",
  "cache_ttl_seconds": 300
}

国家和指标：

• 🇨🇴 哥伦比亚：TRM、DTF、IPC、IBR、Banrep 利率
• 🇲🇽 墨西哥：TIIE、INPC、UDIS、Banxico 利率
• 🇧🇷 巴西：Selic、CDI、IPCA、PTAX
• 🇨🇱 智利：TPM、UF、IPC、USD/CLP
• 🇵🇪 秘鲁：BCRP 利率、USD/PEN、IPC

价格：$0.02——调用量最高的模块，每个 Agent 周期都会调用

---

5. POST /context — LATAM 市场背景 — $0.10 USDC

基于 AI 的特定行业和国家市场背景分析。复用 Intelica 的大模型层，但专注于 LATAM。返回监管环境、主要参与者、市场规模和增长信号。

// Request
{ "sector": "fintech", "country": "CO", "query": "neobanks competitive landscape 2026" }

// Response
{
  "sector": "fintech",
  "country": "CO",
  "market_size_usd": "2.1B",
  "growth_rate_pct": 34,
  "key_players": ["Nequi", "Daviplata", "Rappipay", "Lulo Bank", "Movii"],
  "regulatory_framework": {
    "regulator": "Superintendencia Financiera de Colombia",
    "key_regulations": ["Decreto 1234/2023 sandbox", "SARLAFT 3.0", "Ley 1328 consumidor financiero"],
    "eu_ai_act_applicable": true
  },
  "market_signals": [
    "BancoEstado LATAM expansion signals 12% YoY neobank account growth",
    "SFC approved 3 new sandbox licenses Q1 2026"
  ],
  "audit_hash": "sha256:def456...",
  "source": "VeraData Market Context Engine v1.0"
}

价格：$0.10——价值最高，由 AI 驱动，调用频率最低

---

收入模式

端点	价格	保守估计每日调用量	月收入
/entity	$0.03	500	$450
/sanctions	$0.05	300	$450
/registry	$0.05	200	$300
/rates	$0.02	2,000	$1,200
/context	$0.10	100	$300
保守估计总计		3,100/天	$2,700/月
有 1 家金融科技公司活跃时		20,000/天	$18,000/月

**/rates 为何占主导：**在 LATAM 开展业务的交易、DeFi 和资金管理 Agent 每个周期都需要获取利率——每 5 分钟一次。对于这类用户，保守估计每日 2,000 次调用仍然偏低。

---

技术架构

技术栈（100% 可从 Intelica/TrustBoost 复用）

FastAPI (Python 3.11)
  ├── x402 middleware (CDP Bazaar + PayAI)
  ├── Supabase (caché + audit log + rate limiting)
  └── Render (AWS us-east, misma infra)

Payment Stack:
  ├── CDP Facilitator (Bazaar indexing — probado)
  ├── PayAI (fallback — probado)
  └── Wallets: Base + Solana (mismas de Intelica)

Data Sources (todas públicas y gratuitas):
  ├── RUES Colombia — API pública
  ├── Receita Federal Brasil — scraping + API
  ├── SAT México — API pública
  ├── Banco de la República — API JSON
  ├── Banxico — SIE API (gratuita, registro simple)
  ├── BCB Brasil — API REST pública
  ├── OFAC SDN — descarga diaria CSV
  ├── SARLAFT — actualización mensual UIAF
  └── COAF/UAF/CNBV — listas públicas

数据库架构（Supabase）

-- Caché de entidades (evita llamadas repetidas a registros)
CREATE TABLE entity_cache (
  id BIGSERIAL PRIMARY KEY,
  identifier TEXT NOT NULL,
  country CHAR(2) NOT NULL,
  data JSONB NOT NULL,
  fetched_at TIMESTAMPTZ DEFAULT NOW(),
  expires_at TIMESTAMPTZ,
  UNIQUE(identifier, country)
);

-- Listas de sancionados (actualizadas diariamente)
CREATE TABLE sanctions_lists (
  id BIGSERIAL PRIMARY KEY,
  list_name TEXT NOT NULL,      -- OFAC_SDN, SARLAFT_CO, etc.
  entity_name TEXT NOT NULL,
  entity_type TEXT,             -- person, company
  country TEXT,
  identifiers JSONB,
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

-- Tasas de cambio y macro (caché 5 minutos)
CREATE TABLE rates_cache (
  id BIGSERIAL PRIMARY KEY,
  country CHAR(2) NOT NULL,
  signal TEXT NOT NULL,
  value NUMERIC NOT NULL,
  fetched_at TIMESTAMPTZ DEFAULT NOW(),
  UNIQUE(country, signal)
);

-- Audit log x402 (mismo patrón de Intelica)
CREATE TABLE vera_audit (
  id BIGSERIAL PRIMARY KEY,
  seq_id BIGSERIAL,
  ip_hash TEXT,
  endpoint TEXT,
  country TEXT,
  network TEXT,
  price_usdc NUMERIC,
  trace_id UUID,
  audit_hash TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

x402 支付流程（与 Intelica 完全相同——已在生产环境验证）

Agent → POST /sanctions (sin X-PAYMENT)
Server → 402 + PAYMENT-REQUIRED header (con extensions.bazaar)
Agent → firma EIP-3009 con wallet Base
Agent → POST /sanctions + X-PAYMENT header
Server → CDP verify → CDP settle → extensions.bazaar → "processing"
Server → response JSON + audit_hash
CDP Bazaar → indexa automáticamente (probado Jun 28, 2026)

---

构建计划——4 个阶段

阶段 1——MVP：/rates + /sanctions（第 1 周）

为什么先做这两个：

• /rates 是潜在调用量最大的模块，技术上也最简单——调用各国央行的公共 API，不使用 AI
• /sanctions 将现有 TrustBoost 转变为覆盖 LATAM 的模块——70% 的工作已经完成

交付内容：

• 使用 FastAPI 基础模板创建 veradata 仓库（从 TrustBoost 分叉）
• 编写 Banco de la República（哥伦比亚）的抓取器/数据获取器
• 编写 Banxico（墨西哥）的抓取器/数据获取器
• 编写 BCB（巴西）的抓取器/数据获取器
• 下载并解析 OFAC SDN CSV 的模块
• 解析哥伦比亚 UIAF SARLAFT 名单
• 解析墨西哥 CNBV 名单
• 实现带有 x402 的 /rates 和 /sanctions 端点
• 部署到 Render
• 在 CDP Bazaar 注册（流程已熟悉）
• 在 402 Index 注册
• 在 Agentic Market 注册

阶段 1 预计收入：$600-$1,800/月

---

阶段 2——/entity + /registry（第 2-3 周）

• 集成哥伦比亚 RUES（公共 REST API，无需身份验证）
• 集成 CNPJ Receita Federal（公共 API）
• 集成墨西哥 RFC SAT（SOAP，解析器）
• 在 Supabase 中缓存 24 小时
• 实现带有 x402 的 /entity 和 /registry 端点

阶段 2 预计累计收入：$1,500-$4,500/月

---

阶段 3——/context（第 4 周）

• 复用 Intelica 的大模型层（Claude Haiku）
• 编写专用于 LATAM 市场的提示词
• 集成 /rates，以提供实时宏观背景信息
• 实现带有 x402 的 /context 端点（$0.10）

阶段 3 预计累计收入：$2,700-$8,000/月

---

阶段 4——发现与扩展（第 5 周及以后）

• 注册正交技能（流程与 Intelica PR #60 相同）
• 提交 awesome-x402 PR
• 在 dev.to 发布包含真实用例的技术博客文章
• TrustBoost 交叉推广（将 TB 用户引导至 VeraData）
• Intelica 交叉推广（LATAM 市场分析使用 /rates 和 /entity）

---

竞争优势

VeraData 为什么有机会胜出

1. x402 LATAM 领域的先行者 — Agentic Market 上有 1,357 项服务，但没有任何服务通过 x402 提供哥伦比亚、墨西哥和巴西的结构化数据。窗口期为 6-12 个月。

2. EU AI Act 是催化剂 — 执法将于 August 2, 2026 开始。在 LATAM 使用 AI Agent 的欧洲企业需要 /sanctions 来满足 Art.13 合规要求。这不是可选项。

3. 经过验证的技术栈 — FastAPI + Supabase + Render + x402 + CDP Bazaar 已与 Intelica 和 TrustBoost 一起投入生产。无需学习任何新技术。

4. 免费数据 — 与 Clearbit（$99+/月）等服务或商业信用征信机构 API 不同，VeraData 的所有一手数据来源均为公开数据。净利润率 > 90%。

5. 需求已获验证 — /rates 在 Agentic Market 上的高流量服务（加密货币清算图、DeFi 信号）中有直接对应产品。使用模式完全相同，只是面向 LATAM。

6. Intelica 协同效应 — /context 模块复用 Intelica 的 3,744 节点图谱，并聚焦 LATAM。使用 Intelica 进行竞争分析的 Agent，可以在同一工作流中调用 VeraData 获取宏观数据。

---

发现渠道

与 Intelica 成功采用的方案相同：

渠道	操作	时间
CDP Bazaar	部署 + 使用 intelica_pay.html 完成首次付款	第 1 天
402 Index	curl -X POST https://402index.io/api/v1/register	第 1 天
Agentic Market	通过 CDP Bazaar 自动编入索引	第 1 天
punkpeye/awesome-mcp-servers	提交 PR（Security/Data 部分）	第 1 周
xpaysh/awesome-x402	提交 PR（Live Services 部分）	第 1 周
Orthogonal	SKILL.md（采用与 PR #60 相同的流程）	第 2 周
402 Index TrustBoost	已验证 — 交叉列出 VeraData	第 1 周

---

关键决策与限制

黄金法则（继承自 Intelica/TrustBoost）

• 绝不更改核心模型 — 所有变更均为增量式
• 未经明确确认，绝不删除 Supabase 中的数据
• accepts[] 中始终使用 CAIP-2：eip155:8453 和 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp

技术栈决策

• Python 3.11 — 与 Intelica/TrustBoost 相同，不要更改
• Claude Haiku — /context 使用的 LLM 模型（$0.10 的价格物有所值）
• Supabase Colombia project — 与 Intelica 和 TrustBoost 分开的新项目
• Render free tier — 足以满足 MVP 需求，达到 $500/月时升级

数据新鲜度策略

端点	缓存 TTL	来源
/entity	24 小时	公共记录（很少变更）
/sanctions	24 小时	每日更新的名单
/rates	5 分钟	中央银行 API（实时）
/registry	24 小时	商业登记记录
/context	1 小时	LLM + /rates 实时数据

---

文件结构

veradata/
├── main.py              # FastAPI app principal
├── requirements.txt     # FastAPI, httpx, supabase, PyJWT, cryptography
├── .env.example         # Variables de entorno requeridas
├── README.md            # Este archivo
├── CONTEXT.md           # Historial de decisiones y sesiones
├── fetchers/
│   ├── banrep.py        # Banco de la República Colombia
│   ├── banxico.py       # Banco de México
│   ├── bcb.py           # Banco Central do Brasil
│   ├── rues.py          # RUES Colombia
│   ├── receita.py       # Receita Federal Brasil
│   └── sat.py           # SAT México
├── sanctions/
│   ├── ofac.py          # OFAC SDN downloader + parser
│   ├── sarlaft.py       # UIAF SARLAFT Colombia
│   ├── cnbv.py          # CNBV México
│   ├── coaf.py          # COAF Brasil
│   └── uaf.py           # UAF Chile
└── llms-full.txt        # Machine-readable docs para agentes

---

环境变量

# Supabase (nuevo proyecto VeraData)
SUPABASE_URL=
SUPABASE_SERVICE_KEY=

# x402 Payment
WALLET_ADDRESS=           # Base mainnet (misma de Intelica)
WALLET_SOLANA=            # Solana mainnet (misma de Intelica)
CDP_API_KEY_ID=           # organizations/xxx/apiKeys/xxx (mismo de Intelica)
CDP_API_KEY_SECRET=       # EC private key PEM

# LLM (solo para /context)
ANTHROPIC_API_KEY=

# Pricing
PRICE_ENTITY=0.03
PRICE_SANCTIONS=0.05
PRICE_REGISTRY=0.05
PRICE_RATES=0.02
PRICE_CONTEXT=0.10

# Banxico API (registro gratuito en sie.banxico.org.mx)
BANXICO_TOKEN=

---

背景与来源

VeraData 是同一位创始人打造的第三款产品，他此前还构建了：

• TrustBoost（api.trustboost.dev）— PII 脱敏 API，在 ClawHub 上有 500+ 次下载，已通过 402 Index 验证，awesome-mcp-servers PR #6415 已合并
• Intelica（api.intelica.dev）— 竞争情报 API，自 Jun 28, 2026 起登陆 CDP Bazaar 和 Agentic Market，首笔通过 CDP facilitator 完成的 x402 付款已验证

该技术栈、部署流程和发现方案都已在生产环境中得到验证。VeraData 将运用相同的经验教训，以最快速度执行。

---

开始构建

# Clonar y configurar
git clone https://github.com/teodorofodocrispin-cmyk/veradata-public-public
cd veradata
pip install fastapi uvicorn httpx supabase pyjwt cryptography anthropic

# Configurar variables
cp .env.example .env
# Editar .env con tus valores

# Correr localmente
uvicorn main:app --reload --port 8001

# Test /rates (primer endpoint a construir)
curl -X POST http://localhost:8001/rates \
  -H "Content-Type: application/json" \
  -d '{"country": "CO", "signals": ["usd_cop", "dtf"]}'
# → 402 Payment Required (correcto — x402 funcionando)

---

VeraData — 在 Bogotá, Colombia 打造。Jun 28, 2026。