用途
Patents Search 用于通过自然语言查询检索全球专利数据库，底层由 Valyu 的语义搜索 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 密钥："To search patents, I need your Valyu API key. Get one free ($10 credits) at https://platform.valyu.ai"
- 用户提供密钥后，运行：scripts/search setup <api-key>
- 重试原始搜索。
输出格式
{ "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'
常见用例
现有技术检索：
Find prior art
scripts/search "lithium ion battery electrode materials" 50
竞争情报：
Search competitor patents
scripts/search "CAR-T cell therapy manufacturing methods" 20
技术态势：
Find technology trends
scripts/search "quantum computing error correction patents" 15
自由实施：
Search for blocking patents
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 文档。
适用场景
- 现有技术检索与专利态势分析
- 技术趋势分析
- 竞争对手创新追踪
- 专利自由实施分析
- 专利权利要求分析与解读
- 专利申请策略研究
限制
- 需要 Node.js 18+ 运行环境。
- 需要 Valyu API 密钥，密钥可从 https://platform.valyu.ai 获取（含 10 美元免费额度）。
- 调用会产生费用，输出中的 cost 字段显示本次调用费用。
- 其他限制暂未提供。