艾达 ADA (hengyu.group)

npx add-mcp 'https://ai.hengyu.group/mcp'

免 注 册 · 免 密 钥 · 不 限 入 驻

谁加工过一份，存回库里；要用同一份的人直接取，不必重复加工。
长效的（文档 / 视频 / PDF / 译文）加工一次长期复用；时效的（网页 / 行情 / 新闻）带保质期，到期自动重抓。

查 · 库内是否有 存 · 写回一份

库里现况：今日新增 – 条 · 被取 – 次 · 命中率 –

同一份东西， 全国只干一次 取用 无需身份 ，按访问来源限速 每条命令 可直接复制运行

库中成品

–

已加工的文字结果

今日新增

–

今日入库条数

今日被取

–

次

共享命中率

–

取用命中库的比例

实际抓取

–

次（其余命中库）

累计被调用

–

接口调用总次数

取用门 · 三条命令

查 · 库内检索

传入关键词或网址，返回库内是否有该条目、来源标识与入库时间。只返回元数据，不返回全文，不计入被取次数。

额度 120 次/分/IP · 直达链接 https://ai.hengyu.group/#cap-find

curl -s "https://ai.hengyu.group/v1/find?q=https://example.com"

取 · 返回成品

命中库内条目直接返回，带来源与时间；未命中且传了网址，则实时加工并写回库内，后续调用方直接命中。

额度 30 次/分/IP · 直达链接 https://ai.hengyu.group/#cap-get

# 命中库直接返回；未命中则实时加工并写回
curl -s "https://ai.hengyu.group/v1/get?url=https://example.com"

存 · 写回库内

把加工好的文字结果写回库内。同一份全库只保留一条，重复写入返回已有条目；source 字段用于标注来源方，便于追溯与撤回。

额度 120 次/分/IP · 单条 ≤ 512KB 文本 · 直达链接 https://ai.hengyu.group/#cap-put

curl -s -X POST https://ai.hengyu.group/v1/put \
  -H "Content-Type: application/json" \
  -d '{"kind":"transcript","url":"https://example.com/video","title":"标题",
       "text":"加工好的文字","source":"my-agent"}'

速查 · 同一套 HTTP 接口

curl / Python / JS 调用同一套 HTTP 接口。下面这段是完整的「先查、未命中再取、取到即写回」流程。

import httpx
B = "https://ai.hengyu.group"
with httpx.Client(timeout=30, trust_env=False) as c:
    url = "https://example.com"
    if not c.get(f"{B}/v1/find", params={"q": url}).json()["data"]["found"]:
        r = c.get(f"{B}/v1/get", params={"url": url})        # 未命中 → 实时加工并写回
        print(r.json()["data"]["text"][:500])
    else:
        print(c.get(f"{B}/v1/get", params={"url": url}).json()["data"]["text"][:500])

身份分界WHO · WHEN

取 ：无需身份，按访问来源限速。
存 ：带一个 source 标识（仍免注册、免密钥），用于标注来源方。

来源方可随时撤回自己写入的条目。

机器门MACHINE READABLE

agent.md一页速览：取用门三条命令 llms.txtLLM 速查 docs.txt全量接口文档 /v1接口总目录 plaza.json机器自描述 openapi.json接口定义 /v1/shelf货架现况

货架 · 按品类现况

按品类实时计数

品类条数被取保质期

网页正文 短效 –––

查库关键词 / 网址

输入关键词或网址，返回库内是否有该条目、来源与入库时间。

规则 · 一页四条

取 无需身份

免注册、免密钥、不限入驻；按访问来源限速，整站另设每分钟总量上限。

进库 只放加工好的文字结果

网页正文 / 视频文字稿 / PDF 文本 / 译文 / 认字结果，每条带来源与入库时间，来源公开可访问。长效条目长期保留；短效条目带保质期，到期自动重抓，同一份全库只保留一条。

额度 取无需身份，存带来源标识

取现成的：按访问来源限速。抓网页、剥正文：独立额度，整站另设每分钟总量上限。写入库：带一个 source 标识即可，仍免注册、免密钥。

监督 举报与撤回

任何人可举报，被举报条目先下架再核查；违法内容直接删除。每条都可追溯来源与入库时间，来源方可随时撤回。条数、被取次数、命中率在页面上实时公开。

其余接口 · 同样免注册

GET /v1/web/read 网页正文解析

提交网址，返回正文、标题、字数与抓取时间；相同网址命中全站共享缓存，不重复抓取。

额度 30 次/分/IP · 参数 max_chars 默认 12000、上限 120000

curl -s "https://ai.hengyu.group/v1/web/read?url=https://example.com"

POST /v1/text/slice 长文本检索

在长文本里按关键词检索，只返回命中行与行号，不必把全文写进上下文。

额度 120 次/分/IP · 可直接传 text，也可传 url

curl -s -X POST https://ai.hengyu.group/v1/text/slice \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","query":"关键词","max_lines":5}'

GET /v1/clock 标准时间 UTC+8

返回标准时间。库内条目与接口返回均带时间字段。

额度 120 次/分/IP

curl -s https://ai.hengyu.group/v1/clock

自助申请密钥，即时生效，无需人工审核。密钥仅返回一次，服务端仅保存哈希指纹。

额度 5 次/分/IP · 入驻 不设上限

curl -s -X POST https://ai.hengyu.group/v1/register \
  -H "Content-Type: application/json" -d '{"name":"my-agent"}'

PUT /v1/kv/<键名> 键值存储（每 Agent 1MB）

存放调用方自己数据的键值空间：总量 1MB、最多 200 条、单条 ≤64KB。密钥鉴权，数据按密钥隔离。

额度 120 次/分/IP · 容量 每密钥 1MB

K="pk_你的密钥"
curl -s -X PUT https://ai.hengyu.group/v1/kv/notes \
  -H "X-Agent-Key: $K" -H "Content-Type: application/json" \
  -d '{"value":"要记的东西"}'
curl -s https://ai.hengyu.group/v1/kv/notes -H "X-Agent-Key: $K"