aether-developer

aether-developer

エージェント向けに構築された検索エンジン、SEC 提出書類、決算説明会のトランスクリプト、EU 金融規制を扱うAetherを、LLM、IDE、または独自のコードに接続するために必要なものがすべて揃っています。

すべての検索結果は、そのまま引用できる証拠ペイロードです。提出書類からの正確な抜粋、アクセッション番号付きの引用、sec.gov / EUR-Lex のリンク、信頼度スコアが含まれます。提出書類がなければ回答もありません。エージェントが数字をでっち上げることはありません。

aether-developer/
├── docs/                — connection guides + REST API reference
│   ├── chatgpt.md       — ChatGPT Developer Mode setup
│   ├── mcp.md           — Claude / Cursor / Cline / any MCP client
│   ├── cursor.md        — Cursor specifics (one-click install)
│   └── search.md        — REST API reference (/v1/tools/*), the issuer contract, fetch mode
├── skills/              — Agent Skills (drop into ~/.claude/skills)
├── mcp/                 — @evidinvest/aether-mcp (stdio MCP server, npm)
├── clients/
│   ├── typescript/      — @evidinvest/aether-sdk (npm)
│   └── python/          — evidinvest-aether-sdk (PyPI)
└── examples/            — runnable demos + config snippets

LLM を接続する（コード不要）

MCP エンドポイント： https://api.aether.evidinvest.com/mcp · 認証：OAuth （クライアントから求められたらサインインしてください。無料アカウントで利用できます）。

クライアント	方法	ガイド
ChatGPT	設定 → アプリとコネクター → 開発者モード → 上記 URL を使ってコネクターを作成	docs/chatgpt.md
Claude（Web／デスクトップ）	設定 → コネクター → 上記 URL を使ってカスタムコネクターを追加	docs/mcp.md
Claude Code	claude mcp add --transport http aether https://api.aether.evidinvest.com/mcp	docs/mcp.md
Cursor		docs/cursor.md
Cline / Continue / その他の stdio MCP	クライアントの MCP 設定で npx -y @evidinvest/aether-mcp を実行	docs/mcp.md

次のように質問してください：「Apple の最新の 10-K では、サプライチェーンのリスクについて何と述べていますか？sec.gov のリンクとともに該当箇所を引用してください。」 質問には企業名を指定してください。すべてのツールで issuer が必要です。企業名を指定すると、すべての提出者を関連度順に検索するのではなく、回答の範囲が絞られます。

エージェントに技を教える（スキル）

MCP はエージェントにツールを提供し、skills/ ディレクトリはツールの使い分け、引用の規律、指定時点のトランスクリプト取得といった技を教えます。

cp -r skills/aether-research ~/.claude/skills/   # Claude Code, personal

Claude Desktop やその他のフレームワークについては、skills/README.md を参照してください。

コードから API を呼び出す

4 つの REST エンドポイントがあり、MCP が公開するものと同じツールを利用できます (完全なリファレンス)：

POST /v1/tools/search   ← start here (unified)
POST /v1/tools/financial_search    POST /v1/tools/transcript_search    POST /v1/tools/regulation_search

企業名を指定してから、絞り込んでください。 すべての呼び出しで issuer を渡すと、その提出者に範囲を絞った回答が得られます。高速かつ正確です。省略すると、すべての発行体を一度に検索するため、処理が遅くなり、関連度順のみで結果が返され、レスポンスには quality_caveat が含まれます。絞り込まれた回答を得られたことを保証するのは、注意書きのない scope: "issuer" だけです。両方のフィールドを確認してください。

また、query は任意です。省略して識別子と form_type / fiscal_year / section を渡すと、取得モードになります。その提出書類のセクションが提出書類内の順序で返され、ランキングは行われません。mode: "fetch" となり、数十ミリ秒で処理されます。対象の文書がすでにわかっているなら、ランキングする必要はありません。

TypeScript / Node

pnpm add @evidinvest/aether-sdk

import { AetherClient } from "@evidinvest/aether-sdk";

const aether = new AetherClient({ apiKey: process.env.AETHER_API_KEY });

// search: the question in `query`, the company in `issuer`
const out = await aether.financialSearch({
  query: "supply-chain concentration risk",
  issuer: { ticker: "AAPL" },
  fiscal_year: 2025,
  limit: 5,
});
if (out.quality_caveat) console.warn(out.scope, out.quality_caveat);
for (const c of out.results) {
  const start = c.metadata?.retrieval?.body_offset ?? 0; // skip the EDGAR cover page
  console.log(c.citation, c.metadata?.source_url, c.text.slice(start, start + 200));
}

// fetch: no query — Apple's latest 10-K risk factors, in filing order
const risks = await aether.financialSearch({
  issuer: { ticker: "AAPL" },
  form_type: ["10-K"],
  section: "Item 1A",
  limit: 5,
});
console.log(risks.mode); // "fetch" — and no `confidence` on any hit

Python

pip install evidinvest-aether-sdk

from aether import AetherClient

with AetherClient(api_key="ak_...") as aether:
    out = aether.financial_search(
        query="supply-chain concentration risk",
        issuer={"ticker": "AAPL"},
        fiscal_year=2025,
        limit=5,
    )
    if out.quality_caveat:
        print(out.scope, out.quality_caveat)
    for c in out.results:
        start = c.body_offset or 0          # skip the EDGAR cover page
        print(c.citation, c.metadata.get("source_url"), c.text[start : start + 200])

    # fetch: no query — Apple's latest 10-K risk factors, in filing order
    risks = aether.financial_search(
        issuer={"ticker": "AAPL"}, form_type=["10-K"], section="Item 1A", limit=5
    )
    print(risks.mode)   # "fetch" — and `confidence` is None on every hit

curl / 任意の言語

curl -sS https://api.aether.evidinvest.com/v1/tools/search \
  -H "authorization: Bearer $AETHER_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"supply chain risk Taiwan","issuer":{"ticker":"TSM"},"limit":5}' | jq .

ドキュメント

• docs/search.md — REST API リファレンス：3 つすべてのツール、パラメーター、レスポンス形式。
• docs/regulation_search.md — EU 金融規制検索の詳細（29 の法令）、フィルター、curl。
• docs/mcp.md — あらゆる MCP クライアントの接続方法（リモート URL または stdio）、環境変数の上書き。
• docs/chatgpt.md — ChatGPT の開発者モードの手順。
• docs/cursor.md — Cursor のワンクリックインストール。

API キーを取得する

https://aether.evidinvest.com/developer/keys — 匿名での呼び出しも可能ですが、レート制限があります。キーは無料です。

コーパスの内容

• SEC 提出書類 — 10-K／10-Q／8-K、登録届出書、目論見書、プレスリリースの添付資料。S&P 500 などの企業を対象とする約 10 年分のデータがあります。
• 米国外の登録機関 — スウェーデン（Bolagsverket）、日本（EDINET）、韓国（DART）の年次報告書。issuer: {company_name: "Sivers Semiconductors"} のように企業名を指定して米国外の提出企業にアクセスするか、jurisdiction: ["SE"|"JP"|"KR"] で市場全体を対象にできます。
• 決算説明会 — 発言者を明記した書き起こしと提出済みプレスリリースの添付資料。時点フィルター（order: "earliest" で最初の言及を検索）と、発行体独自の fiscal_year および quarter を利用できます。
• EU 規制 — MiFID II、MiCA、DORA、AML パッケージ。条文単位で引用できます。

3 か月無料です。 登録時にメールアドレスを認証すると、自動的にトライアルティアが適用されます。Aether の検索ツールを 1 時間あたり最大 5,000 回、3 か月間無料で API 呼び出しできます。カード登録は不要です。トライアル終了後は、無料ティア（1 時間あたり 100 回の呼び出し＋有料クレジット）に戻ります。

クライアントライブラリへの貢献

TypeScript と Python のクライアントは、意図的に最小限の実装にしています。/v1/tools/* エンドポイント向けのベアラートークン付き fetch ラッパーと、型定義だけです。Go、Rust、Java などへの移植は約 150 行でできます。clients/<lang>/ に PR を送ってください。どのような実装でも、scope、quality_caveat、mode と、各ヒットの body_offset を提供してください。これらを省略するクライアントでは、ユーザーが正確な回答と近似的な回答を区別できなくなります。テスト用のレスポンスフィクスチャは clients/fixtures/ にあります。

ライセンス

Apache-2.0 — LICENSE を参照してください。