name: open-targets-search description: 使用自然语言查询搜索Open Targets药物-疾病关联和目标验证数据。目标验证由Valyu语义搜索提供支持。 keywords:
- 开放靶点
- 药物靶点
- 目标验证
- 疾病关联
- 精准医学
- 语义搜索 license: MIT
Open Targets搜索
使用Valyu语义搜索API的自然语言查询,搜索完整的Open Targets药物-疾病关联和目标验证数据库。
为什么这个技能强大
- 无需API参数解析:直接传递自然语言查询,无需构建复杂搜索参数
- 语义搜索:理解查询含义,不仅仅是关键词匹配
- 全文本访问:返回完整的目标-疾病关联数据,包括证据评分
- 图像链接:包含可用的数据可视化
- 全面覆盖:访问所有Open Targets药物-疾病关联数据
要求
- Node.js 18+(使用内置fetch)
- Valyu API密钥,从 https://platform.valyu.ai 获取(10美元免费额度)
关键:脚本路径解析
本文档中的 scripts/search 命令相对于此技能的安装目录。
运行任何命令前,使用以下命令定位脚本:
OPEN_TARGETS_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/open-targets-search/*/scripts/*" -type f 2>/dev/null | head -1)
然后对所有命令使用完整路径:
$OPEN_TARGETS_SCRIPT "JAK2抑制剂" 15
API密钥设置流程
当运行搜索并收到 "setup_required": true 时,遵循此流程:
-
向用户询问API密钥: “为了搜索Open Targets,我需要您的Valyu API密钥。在 https://platform.valyu.ai 获取一个免费的(10美元额度)”
-
用户提供密钥后,运行:
scripts/search setup <api-key> -
重试原始搜索。
何时使用此技能
- 疾病的目标验证
- 药物-疾病关联
- 研究目标优先级排序
- 目标的遗传证据
- 目标-疾病通路分析
- 治疗假设验证
输出格式
{
"success": true,
"type": "open_targets_search",
"query": "JAK2抑制剂",
"result_count": 10,
"results": [
{
"title": "目标-疾病关联",
"url": "https://platform.opentargets.org/...",
"content": "关联数据、证据、评分...",
"source": "open-targets",
"relevance_score": 0.95,
"images": ["https://example.com/pathway.png"]
}
],
"cost": 0.025
}
处理结果
使用jq
# 获取关联标题
scripts/search "查询" 10 | jq -r '.results[].title'
# 获取URL
scripts/search "查询" 10 | jq -r '.results[].url'
# 提取完整内容
scripts/search "查询" 10 | jq -r '.results[].content'
常见用例
目标验证
# 查找目标证据
scripts/search "炎症性疾病中的激酶目标" 50
药物重定位
# 搜索重定位机会
scripts/search "靶向IL-6通路的药物" 20
遗传证据
# 查找遗传关联
scripts/search "功能丧失变异保护效应" 15
疾病机制
# 搜索机制洞察
scripts/search "癌症中的免疫检查点目标" 25
错误处理
所有命令返回JSON,带有 success 字段:
{
"success": false,
"error": "错误消息"
}
退出代码:
0- 成功1- 错误(检查JSON获取详情)
API端点
- 基础URL:
https://api.valyu.ai/v1 - 端点:
/search - 认证:X-API-Key 头部
架构
scripts/
├── search # Bash包装器
└── search.mjs # Node.js CLI
使用Node.js内置 fetch() 直接API调用,零外部依赖。
添加到您的项目
如果您正在构建AI项目,并希望将Open Targets搜索直接集成到您的应用中,使用Valyu SDK:
Python集成
from valyu import Valyu
client = Valyu(api_key="您的-api-key")
response = client.search(
query="您的搜索查询",
included_sources=["valyu/valyu-open-targets"],
max_results=20
)
for result in response["results"]:
print(f"标题: {result['title']}")
print(f"URL: {result['url']}")
print(f"内容: {result['content'][:500]}...")
TypeScript集成
import { Valyu } from "valyu-js";
const client = new Valyu("您的-api-key");
const response = await client.search({
query: "您的搜索查询",
includedSources: ["valyu/valyu-open-targets"],
maxResults: 20
});
response.results.forEach((result) => {
console.log(`标题: ${result.title}`);
console.log(`URL: ${result.url}`);
console.log(`内容: ${result.content.substring(0, 500)}...`);
});
查看 Valyu文档 获取完整集成示例和SDK参考。