Home / magicalyuyu / agent-operating-system · GitHub

exa-search SKILL.md skillA

exa-search from magicalyuyu/agent-operating-system is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add magicalyuyu/agent-operating-system/exa-search@git:20261008.e5b1ec6

Pins git:20261008.e5b1ec6 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: magicalyuyu/agent-operating-system
Path: .dsh/skills/exa-search/SKILL.md
Versions recorded: 1
Latest version: git:20261008.e5b1ec6, committed Oct 8, 2026
Size: 2,521 bytes
Repository stars: 4
License: a license file GitHub does not identify

[功能] 需要高质量外部搜索/调研时使用。触发条件：web_search 不可用或需要英文语义搜索、技术/商业调研、多源交叉验证。含 EXA REST/MCP 双路径调用法与渠道质量速查表。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# EXA 高质量搜索

> 背景：当运行环境的内置 web_search 不可用或质量不足时，可用本 skill 的直调路径补位，效果等同插件接入。

## 1. 调用路径（按优先级）

### 路径 A：内置 web_search 工具
搜索插件接入后 `web_search` 自动走 Exa（provider 配置见 harness 设置）。先试它，能用就用。

### 路径 B：REST 直调（带 Key，额度高）
```powershell
$key = [Environment]::GetEnvironmentVariable('EXA_API_KEY','User')  # 或从 {AOS_ROOT}/04_MEMORY/credentials.json（utf-8-sig）读
$body = ConvertTo-Json @{query='...'; numResults=8}   # 可加 type/category/crawl 的 contents
Invoke-RestMethod -Uri 'https://api.exa.ai/search' -Method Post -ContentType 'application/json' -Headers @{'x-api-key'=$key} -Body $body
```

### 路径 C：匿名 MCP（零 Key 兜底，限流）
POST `https://mcp.exa.ai/mcp`（JSON-RPC 2.0，`tools/call web_search_exa`，Header `x-exa-source: <client>`，Accept 含 text/event-stream）。无凭证，429 时换路径 B。

## 2. 渠道质量速查（实测）

| 渠道 | 质量 | 备注 |
|---|---|---|
| EXA（英文查询） | 高 | 语义搜索；**CJK 查询大面积失效**（半数退化为问号/无关页）——中文题先转英文或拆关键词，再用 web_fetch 抓中文源直取 |
| web_fetch 直取 URL | 高 | 已知 URL 一律直取拿一手 |
| 本机实测（SQL/HEAD/API 探测） | 最高 | 能实测不搜索 |
| DuckDuckGo html 端点 | 中 | 引号精确查询会被反爬吞（返回空=可疑） |
| Bing 国内版 | 低 | 频繁返回无关结果，仅作最后手段 |

## 3. gotchas

- credentials.json 是 **UTF-8 带 BOM**：Python 读必须 `encoding='utf-8-sig'`，否则 JSON 解析失败被误诊为文件损坏（多环境共记坑）
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add magicalyuyu/agent-operating-system/exa-search@sha256:bb178d3a2f3862ae

The line at the top of this page pins the label git:20261008.e5b1ec6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_q4h4bxd4uelqagqq.svg)](https://markdownregistry.com/a/art_q4h4bxd4uelqagqq)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 8, 2026.

version	committed	commit	size	audit
git:20261008.e5b1ec6 latest	2026-10-08	e5b1ec6	2,521 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (2521 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

magicalyuyu/agent-operating-system · 4 stars · license a license file GitHub does not identify · pushed 2026-10-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_q4h4bxd4uelqagqq
GET https://markdownregistry.com/api/v1/resolve?ref=magicalyuyu/agent-operating-system/exa-search
GET https://markdownregistry.com/api/v1/blob/bb178d3a2f3862ae86d2dfb29ca42c6c4fc0fa6549eac59326a5b8dcbbecb84a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from magicalyuyu/agent-operating-system

dual-machine SKILL.md skill

magicalyuyu/agent-operating-system · .dsh/skills/dual-machine/SKILL.md · [扩展] 多机协同扩展点说明。触发条件：需要在两台及以上机器间协同 AOS 工作区、或评估跨机同步/部署方案时。本 skill 不含实现，只给边界约定与文档指针。