Apizie Finance

Apizie

数千の公開データソースを、1つの API キーで利用できます。さらに Apizie Finance では、AI エージェント向けに出典付きの公式金融データを提供します。

Apizie は、数千の公開 API を1つの API キーで利用できる、整理された JSON に変換します。また、Claude、ChatGPT、Cursor 向けの MCP サーバーも備えています。Apizie Finance はプレミアムアドオンです。SEC EDGAR、FRED、ECB、米国財務省、GLEIF、世界銀行のデータを1つの REST API と1つの MCP サーバーで利用でき、すべての回答に出典（提供元、公式 URL、取得時刻、ライセンス、帰属表示）が付与されます。

これは、実行時依存関係がゼロ（Node.js ≥ 20）の、完全なセルフホスト可能なプラットフォームです。次の機能が含まれます。

• Apizie Finance（プレミアム）： 6つのソース（finance:sec-edgar、finance:fred、finance:ecb、finance:us-treasury、finance:gleif、finance:worldbank）に加え、official:company と official:macro にある、統合された出典付きエンドポイントを利用できます。これらの利用には有効な Finance プラン（src/core/executor.js で確認される user.financePlan）が必要です。専用の利用枠（src/core/limits.js の fin:<owner> カウンター）を使用し、条件を満たさない場合は 403 finance_plan_required を返します。出典情報は src/core/sources.js にあり、ライセンス保護には FRED の第三者著作権フィルターと SEC のフェアアクセスに基づくリクエスト間隔調整が含まれます。

• データアラート（Finance）： SEC の新規提出書類、FRED の系列、米国財務省のイールドカーブ、ECB の金利、または世界銀行の値を監視し、署名付きの data.changed Webhook を受け取れます（src/core/watches.js、/api/cron/watches で毎日実行される Vercel cron）。

• キーの権限： 新しいキーと MCP 接続はデフォルトで読み取り専用です。カテゴリ単位で制限でき、拒否された呼び出しに料金が請求されることはありません。

• ウェブサイト： アニメーション付き地球儀のヒーローセクション、検索可能なカタログ、「試す」コンソールとコードサンプルを備えたスクレイパーごとのページ、料金、ドキュメント、MCP ページ、ショーケース、ステータスページ、問題報告、法的情報のページを備えたランディングページです。

• アカウント： メールアドレスとパスワードでのサインインに加え、GitHub、Google、Discord の OAuth に対応しています。

• ダッシュボード： 概要、API キー（IP 許可リスト付き）、使用状況グラフ、リクエストログ、一括ジョブ、署名付き Webhook、Dodo Payments によるカード決済（USD）を使った請求、設定を備えています。

• 管理パネル： ユーザーとプラン、請求書の承認、スクレイパーのオン／オフ切り替え、レポート、ショーケースのモデレーションを管理できます。

• API： GET|POST /v1/{category}:{scraper}/{endpoint} による統一されたレスポンス形式、プランと利用枠、分単位のレート制限、キャッシュ、冪等性に対応した一括ジョブ、OpenAPI ファイル、llms.txt を提供します。

• MCP サーバー： AI エージェント向けに8つのツールを備え、/mcp で利用できます。

• グローバル 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 はすぐに利用でき、それ以外は呼び出し元自身のプロバイダーキー（x-upstream-key。保存されません）を使って実行されます。/docs/byok と docs/API-SOURCES.md を参照してください。scripts/build-directory.sh で再構築できます。

• ネイティブのライブモジュール： 公式公開 API、オープンデータ、または提供元の RSS フィードに基づく404の API／930のエンドポイントを備えています。キー不要の公開 API 153件、国際ニュースフィード104件、一般的な RSS／Atom リーダー、オープンデータポータルと研究データリポジトリ（CKAN、Dataverse）30件が含まれます。公開カタログには3,723の API と143,423のエンドポイントがあります（712の API／10,757のエンドポイントは追加キーなしで利用でき、それ以外は独自のプロバイダーキーが必要です）。計画中の202のソースは管理者のみに表示されます。 アーキテクチャと API コントラクトは、REA の手法を用いて実施した、zapi.ink のエビデンスに基づくリバースエンジニアリング調査から得られたものです。docs/REA-REPORT.md（インドネシア語）と docs/evidence/ をご覧ください。zapi のコード、スクレイパーの内部実装、ブランディング、文言は再利用していません。カタログの構造（ソース、エンドポイント名、パラメータスキーマ）は、公開されている OpenAPI インデックスから取り込みましたが、回避カテゴリ（Bypass Tools）は除外しました。

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 を検出して登録し、ユーザーがサインインして「許可」を押します。その他のアプリでは 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 で定義されています。料金はすべて米ドル建てで、Dodo Payments を通じてカードで支払います。プランには 2 つの体系があります。これらの根拠となる調査については、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

クォータ超過分は従量課金となり、プリペイドの米ドル残高からリクエスト 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 には12のセクションがあり、すべて /api/me/*（src/dashboard/account.js）を使用します。

セクション	利用できる機能
ダッシュボード	期間内のリクエスト数、時間帯別トラフィックのヒートマップ（お使いのタイムゾーン）、表示・コピー可能な API キー、予測付きの月間クォータ、本日のリクエスト数、成功率、p95 レイテンシ、過去24時間のエラー数、リクエスト数の推移、最近のリクエスト、上位エンドポイント、カテゴリ、ステータス別のエラー。期間は24H／7D／30D（Pro）／90D（Ultra）から選択でき、キーごとのフィルターも利用できます。
使用状況	合計、過去24時間の数値、キーごとの使用状況テーブル、リクエスト元、上位エンドポイント
ログ	検索（ステータス、エンドポイント、キー、リクエスト ID）、成功／エラーのフィルター、期間、キーのフィルター、cURL で再実行できる詳細パネル、ページネーション、CSV エクスポート。メタデータのみを扱い、ペイロードは保存しません。
API キー	プランごとの上限数まで作成可能。読み取り専用または読み取り・書き込みアクセスとカテゴリ制限を設定できます。再表示、コピー、名前変更、IPv4 CIDR による IP 許可リスト（Pro 以上）、最終書き込み時刻、ワンクリックで読み取り専用にする提案、無効化、削除、30日間のスパークライン、権限を編集できる接続済み MCP アプリ、6言語のコードサンプル
データアラート（Finance）	SEC の提出書類、FRED の系列、米国債利回り曲線、ECB の金利、または World Bank の値を監視できます。今すぐ確認、オン／オフ、署名付き data.changed Webhook に対応します。
一括ジョブ（Ultra、または Finance Growth）	API／エンドポイントの選択機能を使ってダッシュボードから送信できます。ジョブ一覧のフィルター、アイテムごとの結果、JSON ダウンロードに対応します。
Webhook（Pro、または任意の Finance プラン）	最大5つのエンドポイント、イベント選択、テスト、ペイロードを含む配信履歴、再配信、オン／オフ、シークレットのローテーションに対応します。プライベートネットワークおよび localhost の宛先は拒否されます。
請求	プラン、従量課金残高、USD のチャージ（$5～$5,000）、1～12か月分のプラン購入、取引
アフィリエイト	紹介リンク（/?ref=code、有効期間30日の Cookie）、クリック数、登録数、有料顧客数、コミッション履歴、残高への移動、PayPal または SWIFT による出金（最低 $10）
ショーケース、設定、サポート	プロジェクトの投稿、プロフィール写真、名前、パスワード、通知の切り替え、アクティブなセッション、アカウント削除、最新のエラー情報があらかじめ入力されたサポートフォーム

請求の流れ（カード決済、USD）

1. ユーザーは「請求」でプラン（1～12か月）または USD のチャージを選択し、Dodo Payments の決済ページに移動します。税金は決済時に Dodo（Merchant of Record）によって計算されます。
2. Dodo が POST /webhooks/dodo（署名付き、Standard Webhooks）を呼び出します。リターンページからも Dodo に直接問い合わせるため、Webhook の到着が遅れても決済は反映されます。
3. プランは支払い済みの月数分、1か月あたり30日間有効になります。チャージ分は残高に加算されます。invoice.paid Webhook が発火し、顧客が紹介経由の場合、紹介者には APIZIE_AFFILIATE_PERCENT（デフォルトは10%）が付与されます。
4. プランのクォータを使い切ったときに残高を使用する をオンにすると、月間クォータを超えたリクエストは 429 を返す代わりに、1件あたり $0.0004 が残高から差し引かれます（レスポンスヘッダー 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 を遵守する責任はユーザーにあります。