Apizie Finance

io.github.nafadza14由 GitHub 账号 nafadza14 发布v1.0.0更新于 Nov 1, 2026

Official cited financial data layer for AI agents (SEC EDGAR, FRED, ECB, Treasury, GLEIF).

发布方自己的服务:Finance Foundation

已验证Streamable HTTP可网页运行金融开发者工具数据与分析

概览

AI 生成的概览

Apizie Finance 是一个远程 MCP 服务器,让助手访问 SEC EDGAR、FRED、ECB、美国财政部、GLEIF 和世界银行的官方金融与经济数据,并附带引用来源。

可以做什么
  • 搜索并查看 API 目录:search_scrapers、get_scraper_schema、list_categories
  • 调用目录端点并获取带来源的结果:run_scraper
  • 查看账户与用量:get_account、get_usage
  • 提交并跟踪批量任务:bulk_submit、bulk_status
  • 金融增值数据源:SEC EDGAR、FRED、ECB、美国财政部、GLEIF 与世界银行,以及公司、宏观的合并端点,每个结果都带发布方、官方链接、获取时间、许可与署名
适用场景
适合助手需要可溯源的金融或宏观经济数据时,例如公司申报文件、利率、收益率曲线、法人识别码、发展指标,且答案必须注明官方发布方。也适合批量获取大量数据点以及监控数据源变化。
运行要求
远程 Streamable HTTP 端点,位于服务方的 /mcp 路径;支持 OAuth 的客户端需登录并点击允许,其他客户端使用 Bearer 令牌或 x-api-key 请求头发送 API 密钥。金融数据源需要有效的付费 Finance 套餐,否则调用返回 finance_plan_required 错误。自托管部署时 FRED 端点需要免费的 FRED API 密钥。
安装前请注意
金融数据是付费增值项,有月度配额,超额按每千次请求从预付美元余额扣费;套餐以美元信用卡支付。密钥与 MCP 连接默认只读,但可被授予写入权限和类别限制。批量任务与数据提醒 webhook 会把数据发往外部,webhook 目标受限。用量日志只保存请求元数据,不保存响应内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Apizie Finance,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.nafadza14%2Fapizie-finance/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "apizie-finance": {
      "type": "http",
      "url": "https://www.apizie.tech/mcp"
    }
  }
}

README

[Apizie]

Apizie

One API key for thousands of public data sources. Plus Apizie Finance: official financial data with citations for AI agents.

Apizie turns thousands of public APIs into clean JSON behind one API key, with an MCP server for Claude, ChatGPT and Cursor. Apizie Finance is a premium add-on: SEC EDGAR, FRED, the ECB, the U.S. Treasury, GLEIF and the World Bank through one REST API and one MCP server, where every answer carries its source (publisher, official URL, retrieval time, licence, attribution).

It is a complete, self-hostable platform with zero runtime dependencies (Node.js ≥ 20). It includes:

  • Apizie Finance (premium): the six sources (finance:sec-edgar, finance:fred, finance:ecb, finance:us-treasury, finance:gleif, finance:worldbank) plus combined, cited endpoints in official:company and official:macro. They need an active Finance plan (user.financePlan, checked in src/core/executor.js), use their own quota (fin:<owner> counters in src/core/limits.js) and answer 403 finance_plan_required otherwise. Provenance lives in src/core/sources.js; licence guards include the FRED third-party-copyright filter and SEC fair-access pacing.

  • Data alerts (Finance): watch new SEC filings, FRED series, the Treasury curve, ECB rates or World Bank values and get a signed data.changed webhook (src/core/watches.js, daily Vercel cron at /api/cron/watches).

  • Key permissions: new keys and MCP connections are read-only by default, can be limited to categories, and refused calls are never billed.

  • Website: a landing page with the animated globe hero, a searchable catalog, a page per scraper with a "Try it" console and code samples, pricing, docs, the MCP page, a showcase, a status page, issue reporting and legal pages.

  • Accounts: email/password sign-in plus GitHub, Google and Discord OAuth.

  • Dashboard: overview, API keys (with IP allowlists), usage charts, request logs, bulk jobs, signed webhooks, billing with card checkout through Dodo Payments (USD), and settings.

  • Admin panel: users and plans, invoice approval, scraper on/off switches, reports and showcase moderation.

  • API: GET|POST /v1/{category}:{scraper}/{endpoint} with one envelope, plans and quotas, per-minute rate limits, caching, bulk jobs with idempotency, OpenAPI files and llms.txt.

  • MCP server at /mcp with 8 tools for AI agents.

  • Global APIs: 3,319 APIs with about 142,500 operations from official API descriptions: the APIs.guru OpenAPI Directory, AWS (382 services, SigV4-signed), Azure (Resource Manager and data plane, 336), Google (350, Discovery documents), Alibaba Cloud (341, ACS3-signed), Tencent Cloud (254, TC3-signed), Akamai (51, EdgeGrid-signed), HubSpot, Microsoft Fabric, SendGrid, Confluent Cloud, LINE, Webex and other provider-published specs. Keyless ones are live; the rest run with the caller's own provider key (x-upstream-key, never stored). See /docs/byok and docs/API-SOURCES.md; rebuild with scripts/build-directory.sh.

  • Native live modules: 404 APIs / 930 endpoints built on official public APIs, open data or publisher RSS feeds, including 153 keyless public APIs, 104 international news feeds, a general RSS/Atom reader and 30 open-data portals and research-data repositories (CKAN, Dataverse). Public catalog: 3,723 APIs and 143,423 endpoints (712 APIs / 10,757 endpoints live with no extra key, the rest with your own provider key). 202 planned sources are visible to admins only.

The architecture and API contract come from an evidence-backed reverse-engineering study of zapi.ink, done with the REA methodology. See docs/REA-REPORT.md (Bahasa Indonesia) and docs/evidence/. No zapi code, scraper internals, branding or copy is reused. The catalog structure (sources, endpoint names, parameter schemas) was imported from their public OpenAPI index, with the circumvention category (Bypass Tools) removed.

Supabase backend + Google sign-in

  1. Supabase SQL editor: run supabase/migrations/0001_apizie.sql once.
  2. Supabase → Authentication → Providers: enable Google (Google Cloud redirect URI: https://hfscpcwrntvdslxwddjy.supabase.co/auth/v1/callback).
  3. Supabase → Authentication → URL Configuration → Redirect URLs: add https://<your-domain>/auth/supabase/callback (and http://localhost:8787/auth/supabase/callback for local).
  4. Vercel env vars: SUPABASE_PROJECT_ID, SUPABASE_PUBLISHABLE_KEY, SUPABASE_SECRET_KEY, APIZIE_SESSION_SECRET, APIZIE_ADMIN_EMAILS, APIZIE_PUBLIC_URL.
  5. /healthz reports "storage":"SupabaseKV" when connected.

MCP for end users

https://<your-domain>/mcp (Streamable HTTP). Apps that support OAuth (Claude.ai and Claude Desktop custom connectors, ChatGPT, Claude Code /mcp) only need the URL: they discover /.well-known/oauth-protected-resource, register themselves, and the user signs in and presses Allow. Other apps send an API key (Authorization: Bearer apz_… or x-api-key). Setup snippets are on /mcp.

Run locally

bash
git clone https://github.com/nafadza14/zieapi.gitcd zieapinpm start              # → http://localhost:8787
  1. Open http://localhost:8787 and click Sign up. Locally, the first account you create becomes admin.
  2. Go to Dashboard → API keys → Create key.
  3. Call an endpoint:
bash
curl "http://localhost:8787/v1/indonesia:bmkg/gempa-terkini" -H "x-api-key: apz_xxx"

To run the tests: npm test (138 tests).

Deploy to Vercel

  1. Push this repo to GitHub and import it in Vercel (Framework preset: Other). vercel.json already sets the build (npm test), the output (public) and the rewrites to the api/apizie.js function.

  2. Add storage (required): run supabase/migrations/0001_apizie.sql in the Supabase SQL editor and set SUPABASE_PROJECT_ID + SUPABASE_SECRET_KEY (or connect Upstash for Redis, which sets KV_REST_API_URL/KV_REST_API_TOKEN). Without a database, accounts, keys and usage live in memory and vanish between serverless instances; the dashboard shows a red banner and /admin/setup says what is missing.

  3. Set these environment variables:

    NameValue
    APIZIE_PUBLIC_URLhttps://apizie.tech (your domain, no path)
    APIZIE_ADMIN_EMAILSyour email (becomes admin when you sign up)
    APIZIE_SESSION_SECRETany long random string
    DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_PRODUCT_ID, DODO_PAYMENTS_WEBHOOK_SECRET, DODO_PAYMENTS_ENVIRONMENTcard checkout (required for paid plans and top-ups)
    APIZIE_SUPPORT_EMAIL, APIZIE_DISCORD_URLoptional, shown on the Support page
    RESEND_API_KEY, APIZIE_EMAIL_FROMoptional, also email dashboard notifications
    GITHUB_CLIENT_ID/SECRET, GOOGLE_CLIENT_ID/SECRET, DISCORD_CLIENT_ID/SECREToptional OAuth; callback = {APIZIE_PUBLIC_URL}/auth/{provider}/callback
    FRED_API_KEYfree key from fred.stlouisfed.org, needed for every FRED endpoint and official:macro/us
    CRON_SECRETany long random string; Vercel Cron sends it to /api/cron/watches to run data alerts
    APIZIE_SEC_USER_AGENToptional; the User-Agent sent to sec.gov (default Apizie [email protected])
  4. Deploy, open the site, sign up with the admin email, then open /admin/setup: every check should be green or "Review".

All options are listed in .env.example.

API in one table

CallGET or POST /v1/{category}:{scraper}/{endpoint}[/{path-params}]
Authx-api-key: apz_… (or Authorization: Bearer …, or api-key: …)
Success{ "project", "data", "source", "timestamp" } (source = publisher, url, apiUrl, retrievedAt, license, attribution)
Errors{ "content", "message", "errors" }; plan, bulk and quota errors use { "error": { "code", "message" } }
LimitsX-RateLimit-Remaining, X-RateLimit-Remaining-Month, Retry-After. A 5xx is refunded.
BulkPOST …/{endpoint}/bulk {items:[…]} + Idempotency-Key; GET /v1/bulk/{id}
Catalog/api/public/categories, /api/scrapers/list, /api/scrapers/{key}, …/schema, …/stats
Machine docs/openapi.json, /category/{slug}/openapi.json, /llms.txt, /llms-full.txt
MCPPOST /mcp with tools search_scrapers, get_scraper_schema, list_categories, run_scraper, get_account, get_usage, bulk_submit, bulk_status

Plans are defined in src/core/plans.js. Every price is in USD and paid by card through Dodo Payments. There are two schemes; the research behind them is in docs/PRICING.md.

General plans (whole public catalog):

PlanPrice / monthYearly (2 months free)Req/monthReq/min
Free$0-1,000100
Pro$9$9025,0002,000
Ultra$29$290200,0005,000
Max$99$9901,000,00015,000

Pay-as-you-go above the quota: $0.40 per 1,000 requests from a prepaid USD balance.

Apizie Finance (premium add-on, its own quota, no free tier; ids fin_starter, fin_growth, fin_business):

PlanPrice / monthYearlyFinance req/monthLicenceData alerts
Finance Starter$49$490100,000Commercial use inside your company5
Finance Growth$199$1,9901,000,000Use in your own product, with attribution50
Finance Business$499$4,9905,000,000Use in your own product, with attribution200

Finance overage: $1.00 per 1,000 requests from the same balance. Admins can grant Finance from Admin → Customers. Server keys in ZIE_KEYS can carry it too: max+fin_growth:apz_....

Dashboard

/dashboard has twelve sections, all backed by /api/me/* (src/dashboard/account.js):

SectionWhat works
Dashboardrequests in range, traffic-by-hour heatmap (your timezone), API key with reveal/copy, monthly quota with projection, requests today, success rate, p95 latency, errors 24h, requests over time, recent requests, top endpoints, categories, errors by status. Range 24H/7D/30D (Pro)/90D (Ultra) and a per-key filter.
Usagetotals, 24h numbers, per-key usage table, request sources, top endpoints
Logssearch (status, endpoint, key, request ID), success/error filter, range, key filter, detail panel with replay cURL, pagination, CSV export. Metadata only, never payloads.
API keyscreate (limit per plan) with read-only or read and write access and category limits, reveal again, copy, rename, IP allowlist with IPv4 CIDR (Pro+), last-write time and a one-click "make read-only" suggestion, revoke, delete, 30-day sparkline, connected MCP apps with editable permissions, code samples in 6 languages
Data alerts (Finance)watch SEC filings, FRED series, the Treasury curve, ECB rates or World Bank values; check now; on/off; signed data.changed webhooks
Bulk jobs (Ultra, or Finance Growth)submit from the dashboard with an API/endpoint picker, job list with filters, per-item results, JSON download
Webhooks (Pro, or any Finance plan)up to 5 endpoints, event selection, test, delivery history with payload, redeliver, on/off, rotate secret. Private and localhost targets are refused.
Billingplan, pay-as-you-go balance, USD top-ups ($5 to $5,000), plan checkout for 1 to 12 months, transactions
Affiliatereferral link (/?ref=code, 30-day cookie), clicks, sign-ups, paying customers, commission history, move to balance, payout via PayPal or SWIFT (min $10)
Showcase, Settings, Supportproject submissions; profile photo, name, password, notification switches, active sessions, delete account; support form prefilled from your latest errors

Billing flow (card checkout, USD)

  1. The user picks a plan (1 to 12 months) or a USD top-up in Billing and is sent to a Dodo Payments checkout. Tax is calculated at checkout by Dodo (merchant of record).
  2. Dodo calls POST /webhooks/dodo (signed, Standard Webhooks). The return page also asks Dodo directly, so payment is applied even if the webhook is late.
  3. A plan becomes active for 30 days per month paid; a top-up is added to the balance. The invoice.paid webhook fires and, if the customer was referred, the referrer earns APIZIE_AFFILIATE_PERCENT (default 10%).
  4. With Use balance when the plan quota runs out switched on, requests above the monthly quota cost $0.0004 each from the balance instead of returning 429 (response header X-Billing: payg).

Adding scrapers

Copy src/scrapers/_template.js into src/scrapers/live/ and register it in src/scrapers/index.js. A live module with the same category:slug as a catalog entry replaces its planned endpoints. Helpers in src/scrapers/kit.js (getJson, feed, url, ScraperError, requireEnv, …) keep handlers small. Use official APIs or open data only.

Refreshing the global API directory

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

Operators may set shared provider keys with APIZIE_UPSTREAM_KEY_<CATEGORY>_<SLUG> (for example APIZIE_UPSTREAM_KEY_FINANCE_STRIPE). A caller's own x-upstream-key always wins.

Project layout

api/apizie.js            Vercel function entrypublic/assets/           site.css · site.js · dash.css · dash.js (runtime) · dash-user.js · dash-admin.js · faviconsrc/app.js               router: pages, auth, /api/me, /api/admin, /v1, /mcpsrc/core/                catalog · executor · analytics · limits · bulk · webhooks · mcp · openapi · plans · validatesrc/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 · OAuthsrc/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.mddocs/                    REA report + evidencetest/                    node:test suites

License

MIT © Zieads. Not affiliated with Zapi / Zeative Labs. You are responsible for complying with each data source's terms and with UU PDP.

来源:README.md,提交 dc1137d

工具

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

版本历史

1
  1. v1.0.0最新Nov 1, 2026

评分

已满足适用检查项的 85%

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

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

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

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

其他 Finance 集成