Apizie Finance

Apizie

一个 API 密钥即可调用数千个公共数据源。此外还有 Apizie Finance：为 AI Agent 提供附带引用的官方金融数据。

Apizie 将数千个公共 API 整合为干净的 JSON，只需一个 API 密钥即可调用，并提供 MCP 服务，支持 Claude、ChatGPT 和 Cursor。Apizie Finance 是一项高级附加服务：通过一个 REST API 和一个 MCP 服务，即可获取 SEC EDGAR、FRED、ECB、U.S. Treasury、GLEIF 和 World Bank 的数据，且每个回答都附带数据来源（发布方、官方 URL、获取时间、许可证和署名信息）。

这是一个完整的可自托管平台，运行时零依赖（Node.js ≥ 20）。其中包括：

• Apizie Finance（高级版）： 六个数据源（finance:sec-edgar、finance:fred、finance:ecb、finance:us-treasury、finance:gleif、finance:worldbank），以及 official:company 和 official:macro 中的综合引用端点。使用这些功能需要有效的 Finance 方案（user.financePlan，在 src/core/executor.js 中检查），并使用独立配额（src/core/limits.js 中的 fin:<owner> 计数器）；否则会返回 403 finance_plan_required。来源信息存储在 src/core/sources.js；许可证防护措施包括 FRED 第三方版权过滤器和 SEC 公平访问频率控制。

• 数据提醒（Finance）： 监控 SEC 文件、FRED 序列、Treasury 曲线、ECB 汇率或 World Bank 数据的新内容，并接收已签名的 data.changed webhook（src/core/watches.js，Vercel 每日 cron 任务：/api/cron/watches）。

• 密钥权限： 新密钥和 MCP 连接默认设为只读，可限制使用类别，拒绝的调用绝不会计费。

• 网站： 着陆页包含动态地球仪主视觉、可搜索目录、每个爬虫的独立页面（含“试用”控制台和代码示例）、定价、文档、MCP 页面、展示区、状态页、问题反馈和法律页面。

• 账户： 支持邮箱/密码登录，以及 GitHub、Google 和 Discord OAuth。

• 仪表板： 概览、API 密钥（含 IP 允许列表）、用量图表、请求日志、批量任务、已签名 webhook、通过 Dodo Payments（USD）进行银行卡结账的账单功能，以及设置。

• 管理面板： 用户和方案、发票审批、爬虫启用/关闭开关、报告和展示区内容审核。

• API： GET|POST /v1/{category}:{scraper}/{endpoint}，提供统一封装、方案和配额、每分钟速率限制、缓存、支持幂等性的批量任务、OpenAPI 文件和 llms.txt。

• 位于 /mcp 的 MCP 服务，包含 8 个供 AI Agent 使用的工具。

• 全球 API： 来自官方 API 描述的 3,319 个 API，约含 142,500 个操作：包括 APIs.guru OpenAPI Directory、AWS（382 项服务，使用 SigV4 签名）、Azure（Resource Manager 和数据平面，336 项）、Google（350 项，Discovery 文档）、Alibaba Cloud（341 项，使用 ACS3 签名）、Tencent Cloud（254 项，使用 TC3 签名）、Akamai（51 项，使用 EdgeGrid 签名）、HubSpot、Microsoft Fabric、SendGrid、Confluent Cloud、LINE、Webex，以及其他由服务提供商发布的规范。无需密钥的 API 可直接使用；其余 API 使用调用方自己的服务提供商密钥（x-upstream-key，绝不存储）。参见 /docs/byok 和 docs/API-SOURCES.md；使用 scripts/build-directory.sh 重新构建。

• 原生实时模块： 404 个 API / 930 个端点，基于官方公共 API、开放数据或发布方 RSS 订阅源构建，包括 153 个无需密钥的公共 API、104 个国际新闻订阅源、通用 RSS/Atom 阅读器，以及 30 个开放数据门户和研究数据仓库（CKAN、Dataverse）。公共目录：3,723 个 API 和 143,423 个端点（712 个 API / 10,757 个端点无需额外密钥即可实时使用，其余需使用你自己的服务提供商密钥）。另有 202 个计划中的数据源，仅管理员可见。 架构和 API 契约源自一项有证据支持的 zapi.ink 逆向工程研究，该研究采用了 REA 方法。请参阅 docs/REA-REPORT.md（印度尼西亚语）和 docs/evidence/。未复用任何 zapi 代码、爬虫内部实现、品牌或文案。目录的结构（来源、端点名称、参数架构）取自其公开的 OpenAPI 索引，并移除了规避类别（绕过工具）。

Supabase 后端 + Google 登录

1. Supabase SQL 编辑器：运行一次 supabase/migrations/0001_apizie.sql。
2. Supabase → Authentication → Providers：启用 Google（Google Cloud 重定向 URI：https://hfscpcwrntvdslxwddjy.supabase.co/auth/v1/callback）。
3. Supabase → Authentication → URL Configuration → Redirect URLs：添加 https://<your-domain>/auth/supabase/callback（本地环境还需添加 http://localhost:8787/auth/supabase/callback）。
4. Vercel 环境变量：SUPABASE_PROJECT_ID、SUPABASE_PUBLISHABLE_KEY、SUPABASE_SECRET_KEY、APIZIE_SESSION_SECRET、APIZIE_ADMIN_EMAILS、APIZIE_PUBLIC_URL。
5. 连接后，/healthz 会报告 "storage":"SupabaseKV"。

面向最终用户的 MCP

https://<your-domain>/mcp（Streamable HTTP）。支持 OAuth 的应用（Claude.ai 和 Claude Desktop 自定义连接器、ChatGPT、Claude Code /mcp）只需提供 URL：它们会发现 /.well-known/oauth-protected-resource 并自行注册，然后用户登录并点击 Allow。其他应用则发送 API 密钥（Authorization: Bearer apz_… 或 x-api-key）。设置示例见 /mcp。

本地运行

git clone https://github.com/nafadza14/zieapi.git
cd zieapi
npm start              # → http://localhost:8787

1. 打开 http://localhost:8787 并点击 Sign up。在本地，创建的第一个账户会成为管理员。
2. 前往 Dashboard → API keys → Create key。
3. 调用一个端点：

curl "http://localhost:8787/v1/indonesia:bmkg/gempa-terkini" -H "x-api-key: apz_xxx"

运行测试：npm test（138 项测试）。

部署到 Vercel

1. 将此仓库推送到 GitHub 并在 Vercel 中导入（框架预设：Other）。vercel.json 已设置构建命令（npm test）、输出目录（public）以及指向 api/apizie.js 函数的重写规则。

2. **添加存储（必需）：**在 Supabase SQL 编辑器中运行 supabase/migrations/0001_apizie.sql，并设置 SUPABASE_PROJECT_ID + SUPABASE_SECRET_KEY（或者连接 Upstash for Redis，它会设置 KV_REST_API_URL/KV_REST_API_TOKEN）。如果没有数据库，账户、密钥和用量会存储在内存中，并在无服务器实例之间消失；控制面板会显示红色横幅，/admin/setup 会说明缺少哪些内容。

3. 设置以下环境变量：

   名称	值
   APIZIE_PUBLIC_URL	https://apizie.tech（你的域名，不含路径）
   APIZIE_ADMIN_EMAILS	你的电子邮件地址（注册后将成为管理员）
   APIZIE_SESSION_SECRET	任意较长的随机字符串
   DODO_PAYMENTS_API_KEY、DODO_PAYMENTS_PRODUCT_ID、DODO_PAYMENTS_WEBHOOK_SECRET、DODO_PAYMENTS_ENVIRONMENT	信用卡结账（付费方案和充值必需）
   APIZIE_SUPPORT_EMAIL、APIZIE_DISCORD_URL	可选，显示在支持页面
   RESEND_API_KEY、APIZIE_EMAIL_FROM	可选，也用于发送控制面板通知邮件
   GITHUB_CLIENT_ID/SECRET、GOOGLE_CLIENT_ID/SECRET、DISCORD_CLIENT_ID/SECRET	可选的 OAuth；回调地址 = {APIZIE_PUBLIC_URL}/auth/{provider}/callback
   FRED_API_KEY	从 fred.stlouisfed.org 获取的免费密钥，所有 FRED 端点和 official:macro/us 均需要
   CRON_SECRET	任意较长的随机字符串；Vercel Cron 会将其发送到 /api/cron/watches 以运行数据警报
   APIZIE_SEC_USER_AGENT	可选；发送至 sec.gov 的 User-Agent（默认值为 Apizie [email protected]）

4. 部署、打开网站并使用管理员电子邮件地址注册，然后打开 /admin/setup：所有检查都应显示绿色或“Review”。

所有选项都列在 .env.example 中。

API 一览表

调用	GET 或 POST /v1/{category}:{scraper}/{endpoint}[/{path-params}]
身份验证	x-api-key: apz_…（或 Authorization: Bearer …，或 api-key: …）
成功响应	{ "project", "data", "source", "timestamp" }（source = publisher、url、apiUrl、retrievedAt、license、attribution）
错误	{ "content", "message", "errors" }；计划、批量和配额错误使用 { "error": { "code", "message" } }
限制	X-RateLimit-Remaining、X-RateLimit-Remaining-Month、Retry-After。5xx 错误会退还额度。
批量	POST …/{endpoint}/bulk {items:[…]} + Idempotency-Key；GET /v1/bulk/{id}
目录	/api/public/categories、/api/scrapers/list、/api/scrapers/{key}、…/schema、…/stats
机器可读文档	/openapi.json、/category/{slug}/openapi.json、/llms.txt、/llms-full.txt
MCP	使用以下工具的 POST /mcp：search_scrapers、get_scraper_schema、list_categories、run_scraper、get_account、get_usage、bulk_submit、bulk_status

计划定义于 src/core/plans.js。所有价格均以 USD 计，并通过 Dodo Payments 使用银行卡支付。共有两种方案；相关研究见 docs/PRICING.md。

通用计划（适用于整个公开目录）：

计划	月费	年费（免费 2 个月）	每月请求数	每分钟请求数
Free	$0	-	1,000	100
Pro	$9	$90	25,000	2,000
Ultra	$29	$290	200,000	5,000
Max	$99	$990	1,000,000	15,000

超出配额后按量付费：从预付 USD 余额中扣除，每 1,000 次请求收费 $0.40。

Apizie Finance（高级附加服务，拥有独立配额，无免费层级；ID 为 fin_starter、fin_growth、fin_business）：

计划	月费	年费	每月 Finance 请求数	许可证	数据提醒
Finance Starter	$49	$490	100,000	可在公司内部商用	5
Finance Growth	$199	$1,990	1,000,000	可用于自己的产品，需注明出处	50
Finance Business	$499	$4,990	5,000,000	可用于自己的产品，需注明出处	200

Finance 超额费用：从同一余额中扣除，每 1,000 次请求收费 $1.00。管理员可在 Admin → Customers 中授予 Finance 权限。ZIE_KEYS 中的服务端密钥也可携带该权限：max+fin_growth:apz_...。

仪表板

/dashboard 有十二个分区，数据均来自 /api/me/*（src/dashboard/account.js）：

分区	功能
仪表板	时间范围内的请求数、流量按小时热力图（使用你的时区）、可显示/复制的 API 密钥、含预测值的月度配额、今日请求数、成功率、p95 延迟、过去 24 小时的错误数、请求随时间变化、近期请求、热门端点、类别、按状态码统计的错误。可选范围：24H/7D/30D（Pro）/90D（Ultra），并可按密钥筛选。
用量	总量、24 小时数据、按密钥统计的用量表、请求来源、热门端点
日志	搜索（状态、端点、密钥、请求 ID）、成功/错误筛选、时间范围、密钥筛选、包含重放 cURL 的详情面板、分页、CSV 导出。仅含元数据，绝不包含负载。
API 密钥	创建密钥（数量受套餐限制），设置只读或读写权限及类别限制；再次显示、复制、重命名；设置 IP 允许列表（Pro+ 支持 IPv4 CIDR）；查看最后写入时间，并提供一键“设为只读”建议；撤销、删除；30 天迷你趋势图；查看并编辑已连接 MCP 应用的权限；提供 6 种语言的代码示例
数据提醒（Finance）	监控 SEC 文件、FRED 序列、美国国债收益率曲线、ECB 利率或 World Bank 数据；立即检查；启用/停用；已签名的 data.changed Webhook
批量任务（Ultra 或 Finance Growth）	在仪表板中通过 API/端点选择器提交任务；查看带筛选条件的任务列表、各项结果；下载 JSON
Webhook（Pro 或任意 Finance 套餐）	最多 5 个端点；选择事件、测试；查看含负载的投递历史、重新投递、启用/停用、轮换密钥。拒绝指向私有地址和 localhost 的目标。
账单	套餐、按量付费余额、美元充值（$5 至 $5,000）、购买 1 至 12 个月套餐、交易记录
联盟推广	推荐链接（/?ref=code，30 天 Cookie）、点击数、注册数、付费客户数、佣金记录、转入余额、通过 PayPal 或 SWIFT 提现（最低 $10）
展示、设置、支持	项目提交；个人资料照片、姓名、密码、通知开关、活跃会话、删除账户；支持表单会自动填入你最近的错误信息

账单流程（银行卡结账，美元）

1. 用户在“账单”中选择套餐（1 至 12 个月）或美元充值，然后跳转到 Dodo Payments 结账页面。税款由 Dodo 在结账时计算（登记商户）。
2. Dodo 调用 POST /webhooks/dodo（使用 Standard Webhooks 签名）。返回页面也会直接向 Dodo 查询，因此即使 Webhook 延迟，付款仍会生效。
3. 套餐按每月付费时长激活 30 天；充值金额会加入余额。触发 invoice.paid Webhook；如果客户由推荐人引荐，推荐人将获得 APIZIE_AFFILIATE_PERCENT（默认 10%）的佣金。
4. 开启 套餐配额用尽后使用余额 后，超出月度配额的请求将从余额中按每次 $0.0004 扣费，而不会返回 429（响应标头 X-Billing: payg）。

添加爬虫

将 src/scrapers/_template.js 复制到 src/scrapers/live/，并在 src/scrapers/index.js 中注册。与目录条目具有相同 category:slug 的实时模块会替换其计划端点。src/scrapers/kit.js 中的辅助工具（getJson、feed、url、ScraperError、requireEnv、……）可让处理程序保持简洁。仅使用官方 API 或开放数据。

刷新全局 API 目录

npm i --no-save openapi-directory
node scripts/import-openapi.js node_modules/openapi-directory/api

运营人员可以通过 APIZIE_UPSTREAM_KEY_<CATEGORY>_<SLUG> 设置共享的提供商密钥（例如 APIZIE_UPSTREAM_KEY_FINANCE_STRIPE）。调用者自己的 x-upstream-key 始终优先。

项目结构

api/apizie.js            Vercel function entry
public/assets/           site.css · site.js · dash.css · dash.js (runtime) · dash-user.js · dash-admin.js · favicon
src/app.js               router: pages, auth, /api/me, /api/admin, /v1, /mcp
src/core/                catalog · executor · analytics · limits · bulk · webhooks · mcp · openapi · plans · validate
src/dashboard/           account.js (/api/me/*) · setup.js (production checks)
src/db/                  kv.js (Memory / Upstash / Supabase) · repo.js (users, keys, usage, logs, invoices…)
src/auth/                passwords · sessions · API keys · OAuth
src/web/                 html layout + pages (home, catalog, pricing, docs, misc)
src/catalog/seed.js      catalog structure (generated by scripts/import-catalog.js)
src/scrapers/live/       live scraper modules (finance, indonesia, news, research-dev, media-apps, devtools)
brand/                   logo masters, icons, PNGs, presentation board, GUIDELINES.md
docs/                    REA report + evidence
test/                    node:test suites

许可证

MIT © Zieads。与 Zapi / Zeative Labs 无关联。你有责任遵守各数据源的条款以及 UU PDP。