aether-developer

aether-developer

连接 Aether 所需的一切——这款专为 Agent 打造的搜索引擎，覆盖 SEC 文件、财报电话会议文字记录和欧盟金融法规——无论是连接到你的大模型、IDE，还是你自己的代码。

每条结果都是可直接引用的证据内容：原文中的确切段落、带 accession number 的引用、sec.gov / EUR-Lex 链接，以及置信度评分。没有文件，就没有答案——你的 Agent 不会再编造数字。

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

连接你的大模型（无需编写代码）

MCP 端点： https://api.aether.evidinvest.com/mcp · 身份验证：OAuth （客户端提示时登录——免费账户）。

客户端	操作方法	指南
ChatGPT	Settings → Apps & Connectors → Developer mode → 使用上方的 URL 创建连接器	docs/chatgpt.md
Claude（网页端/桌面端）	Settings → Connectors → 使用上方的 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

然后提问：“苹果最新的 10-K 关于供应链风险说了什么？ 请引用相关段落并附上 sec.gov 链接。” 在问题中注明公司名称——每个工具都需要 issuer，注明公司名称才能限定答案范围，而不是对所有申报者进行按相关性排序的检索。

教会你的 Agent 专业方法（技能）

MCP 为 Agent 提供工具；skills/ 目录则教它专业方法——工具路由、引用规范，以及按时间点检索电话会议文字记录：

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

Claude Desktop / 其他框架的说明，请参阅 skills/README.md。

在代码中调用 API

四个 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" 且没有任何 caveat，才能保证你获得的是经过筛选的答案，因此要同时检查这两个字段。

此外，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 参考：全部三个工具、参数和响应结构。
• docs/regulation_search.md — 欧盟金融法规搜索深入指南（29 项法规）、筛选条件和 curl。
• docs/mcp.md — 连接任意 MCP 客户端（远程 URL 或 stdio）、环境变量覆盖。
• docs/chatgpt.md — ChatGPT Developer Mode 操作指南。
• docs/cursor.md — Cursor 一键安装。

获取 API 密钥

https://aether.evidinvest.com/developer/keys — 匿名调用可用，但会受到速率限制；密钥免费。

语料库包含什么

• SEC 文件 — 10-K / 10-Q / 8-K、注册声明、 招股说明书、新闻稿附件；涵盖约 10 年的标普 500 企业及其他公司。
• 非美国注册机构 — 瑞典（Bolagsverket）、日本（EDINET）、 韩国（DART）的年度报告。按名称查找非美国申报企业 — issuer: {company_name: "Sivers Semiconductors"} — 或通过 jurisdiction: ["SE"|"JP"|"KR"]限定整个市场。
• 业绩电话会议 — 标注发言者的文字稿 + 提供的新闻稿附件，支持时间点筛选 （order: "earliest"可查找首次提及），并使用发行人自身的 fiscal_year + quarter。
• 欧盟法规 — MiFID II、MiCA、DORA、反洗钱一揽子法规；支持精确到条款的引用。

免费试用 3 个月。 注册时验证邮箱，即可自动进入试用套餐——使用 Aether 的搜索工具，每小时最多可调用 API 5,000 次，免费试用 3 个月。无需绑定银行卡；试用结束后将恢复免费套餐（每小时 100 次调用 + 付费额度）。

贡献客户端库

TypeScript 和 Python 客户端有意保持精简——只包含一个 Bearer 令牌请求封装，以及 /v1/tools/* 端点的类型化结构。移植到 Go、 Rust、Java 等语言约需 150 行代码。请在 clients/<lang>/ 下提交 PR。无论编写哪种客户端，都要保留 scope、quality_caveat、mode 以及每条命中的 body_offset： 如果客户端丢弃这些字段，用户就无法判断答案是精确还是近似。用于对照测试的响应样例位于 clients/fixtures/。

许可证

Apache-2.0 — 参见 LICENSE。