Patents Search 是一个专利检索技能，使用自然语言查询对完整的全球专利数据库进行搜索，搜索能力由 Valyu 的语义搜索 API 提供。
用途 该技能适用于多种专利相关场景，包括先前技术检索（prior art）与专利态势分析（patent landscapes）、技术趋势分析、竞争对手创新追踪、专利自由实施分析（freedom-to-operate）、专利权利要求分析与解读，以及专利申请策略研究。
主要能力
- 无需解析 API 参数：直接传入自然语言查询即可，无需构造复杂的搜索参数。
- 语义搜索：理解查询的含义，而不仅仅是关键词匹配。
- 全文访问：返回完整的专利信息，包括权利要求、说明书和技术细节。
- 图片链接：在可用时包含专利图表和附图。
- 覆盖范围广：可访问跨司法辖区的全球专利数据。
运行要求
- Node.js 18+（使用内置 fetch）。
- Valyu API 密钥，可从 https://platform.valyu.ai 获取（提供 10 美元免费额度）。
脚本路径解析 文档中的 scripts/search 命令相对于该技能的安装目录。运行任何命令前，先定位脚本：
PATENTS_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "/patents-search//scripts/*" -type f 2>/dev/null | head -1)
然后对所有命令使用完整路径：
$PATENTS_SCRIPT "CRISPR gene editing methods" 15
API 密钥设置流程 当运行搜索并收到 "setup_required": true 时，执行以下流程：
- 向用户索取其 API 密钥：“要搜索专利，我需要你的 Valyu API 密钥。可在 https://platform.valyu.ai 免费获取（10 美元额度）。”
- 用户提供密钥后，运行：
scripts/search setup <api-key>
- 重试原始搜索。
输出格式 搜索返回以下 JSON 结构：
{ "success": true, "type": "patents_search", "query": "CRISPR gene editing methods", "result_count": 10, "results": [ { "title": "Patent Title", "url": "https://patents.google.com/...", "content": "Patent claims, description, technical details...", "source": "patents", "relevance_score": 0.95, "images": ["https://example.com/diagram.png"] } ], "cost": 0.025 }
处理结果（使用 jq）
Get patent titles
scripts/search "query" 10 | jq -r '.results[].title'
Get URLs
scripts/search "query" 10 | jq -r '.results[].url'
Extract full content
scripts/search "query" 10 | jq -r '.results[].content'
常见使用示例
先前技术检索： scripts/search "lithium ion battery electrode materials" 50
竞争情报： scripts/search "CAR-T cell therapy manufacturing methods" 20
技术态势： scripts/search "quantum computing error correction patents" 15
自由实施： scripts/search "mRNA vaccine delivery systems" 25
错误处理 所有命令返回带 success 字段的 JSON：
{ "success": false, "error": "Error message" }
退出码：
- 0 - 成功
- 1 - 错误（查看 JSON 了解详情）
API 端点
- Base URL：https://api.valyu.ai/v1
- Endpoint：/search
- Authentication：X-API-Key header
架构 scripts/ ├── search # Bash wrapper └── search.mjs # Node.js CLI
直接使用 Node.js 内置 fetch() 进行 API 调用，无外部依赖。
集成到项目中 如果正在构建 AI 项目并希望将 Patents Search 直接集成到应用中，可使用 Valyu SDK。
Python 集成：
from valyu import Valyu
client = Valyu(api_key="your-api-key")
response = client.search( query="your search query here", included_sources=["valyu/valyu-patents"], max_results=20 )
for result in response["results"]: print(f"Title: {result['title']}") print(f"URL: {result['url']}") print(f"Content: {result['content'][:500]}...")
TypeScript 集成：
import { Valyu } from "valyu-js";
const client = new Valyu("your-api-key");
const response = await client.search({ query: "your search query here", includedSources: ["valyu/valyu-patents"], maxResults: 20 });
response.results.forEach((result) => {
console.log(Title: ${result.title});
console.log(URL: ${result.url});
console.log(Content: ${result.content.substring(0, 500)}...);
});
完整集成示例与 SDK 参考见 Valyu 文档。