Katzilla

300 多个免费公共及政府数据源集成于一个 API 密钥之下 —— 专为 AI 智能体打造的数据 API。

Katzilla 将原始公共数据（美国联邦数据、判例法、健康、灾害、经济、17 个以上的国际开放数据门户、欧盟统计局、欧洲央行、世界卫生组织、经合组织、国际货币基金组织、世界银行等）聚合在单一 REST API 和 MCP 服务器之后。每个响应都附带结构化的 citation 元数据（来源、许可、URL、更新频率）和 quality 评分（新鲜度、正常运行时间、完整性、置信度）。

在 https://katzilla.dev/dashboard 获取免费 API 密钥。

MCP 服务器

使用 Katzilla 最快的方法是将其作为 Claude Desktop、Cursor、Windsurf、Continue 或任何 stdio MCP 客户端中的 MCP 服务器。

Claude Desktop

编辑 claude_desktop_config.json：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "katzilla": {
      "command": "npx",
      "args": ["-y", "@katzilla/mcp"],
      "env": {
        "KATZILLA_API_KEY": "kz_your_key_here"
      }
    }
  }
}

Cursor

添加到 ~/.cursor/mcp.json（或项目本地的 .cursor/mcp.json）：

{
  "mcpServers": {
    "katzilla": {
      "command": "npx",
      "args": ["-y", "@katzilla/mcp"],
      "env": {
        "KATZILLA_API_KEY": "kz_your_key_here"
      }
    }
  }
}

重启客户端 —— Katzilla 的工具将出现在 MCP 菜单中。完整的 MCP 包文档：packages/mcp/README.md。

TypeScript SDK

npm install @katzilla/sdk

import { Katzilla } from "@katzilla/sdk";

const kz = new Katzilla({ apiKey: process.env.KATZILLA_API_KEY! });

const quakes = await kz.agent("hazards").action("usgs-earthquakes", {
  minMagnitude: 5,
});
console.log(quakes.data, quakes.citation);

REST API

curl -X POST https://api.katzilla.dev/agents/hazards/actions/usgs-earthquakes \
  -H "X-API-Key: kz_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"minMagnitude": 5, "limit": 10}'

公共端点（无需认证）：/health、/status、/openapi.json、/agents、/agents/tools、/agents/datasets。

数据覆盖范围

• 美国联邦 — congress.gov、SEC EDGAR、联邦公报、Regulations.gov、USAspending、FEC、govinfo、国务院

• 美国判例法 — CourtListener（各级法院判决意见）

• 美国健康 — FDA 召回/不良事件/设备、NIH ClinicalTrials.gov、CMS、CDC

• 美国灾害 — USGS 地震与水文、NWS 警报、FEMA 灾害、NASA FIRMS 野火

• 经济 — BLS、FRED、BEA、人口普查局 ACS、财政部财政数据

• 国际门户 — 英国、法国、德国、加拿大、澳大利亚、巴西、爱尔兰、西班牙、意大利、波兰等

• 国际机构 — 欧盟统计局、欧洲央行、世界卫生组织、经合组织、国际货币基金组织、世界银行、联合国商品贸易统计数据库、斯德哥尔摩国际和平研究所

• ……以及加密货币、太空、人口统计、能源、交通、农业。

完整来源列表请见 https://katzilla.dev。

仓库布局

Monorepo（pnpm 工作区）。

开发

pnpm install
pnpm build          # build all packages
pnpm dev            # dev mode (api + app in parallel)
pnpm dev:api        # api only
pnpm dev:app        # frontend only
pnpm typecheck      # typecheck all packages
pnpm test:e2e       # Playwright E2E tests (needs app on :5173)

必需的环境变量：DATABASE_URL、JWT_SECRET、CREDENTIAL_ENCRYPT_KEY。 数据源密钥（可选，自带密钥）：DATA_GOV_API_KEY、FRED_API_KEY、BLS_API_KEY 等。请参阅 .env.example。

链接

• 网站与仪表板 — https://katzilla.dev

• API 文档 — https://api.katzilla.dev/openapi.json

• 问题反馈 — https://github.com/codeislaw101/katzilla/issues

许可

MIT