# Tavily Search

> Tavily API ile güvenli web arama ve URL içerik çıkarma yap. Use when: hızlı web araştırması, kaynaklı sonuç toplama, belirli URL'lerden metin çekme ve özetleme gerektiğinde.

- Skill: `marucie/tavily-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add marucie/tavily-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/marucie/tavily-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: MARUCIE (https://skillmd.com/u/marucie)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/marucie/tavily-search

---


## 是什么

把 Tavily API 包装成一条"安全检索 + 指定 URL 抽正文"的轻量通道，帮你在写报告前几分钟就拿到一组带来源的检索结果，或者把若干指定网页的正文一次性提取出来做摘要，而不必逐个手动复制粘贴。

## 怎么用

1. 先确认环境里有 `TAVILY_API_KEY`，绝不要把它写进文件、提交到仓库、或者出现在任何输出里。
2. 普通检索调用 `search.mjs`，传入查询词；要扩大召回用 `-n 8`，要更深的来源走 `--deep`。
3. 新闻类话题用 `--topic news --days 3` 限定近 3 天，避免拿到过期素材污染分析。
4. 已知 URL 的正文抽取走 `extract.mjs`，可以一次传多个 URL，按需做并行摘要。
5. 严格遵守安全护栏：只接受 http / https，拒绝 localhost、私有 IP、`.local` / `.internal` 域名，单次请求 URL 数量控制在脚本默认上限内。

## 架构图

```mermaid
flowchart LR
  A[查询词或 URL 列表] --> B{任务类型}
  B -->|检索| C[search.mjs]
  B -->|抽正文| D[extract.mjs]
  C --> E[Tavily API + 安全过滤]
  D --> E
  E --> F[带来源的结果]
```

# Tavily Search (Secure)

Tavily API ile güvenli arama/extract akışı çalıştır.

## Gereksinim

- `TAVILY_API_KEY` ortam değişkeni tanımlı olmalı.
- API anahtarını dosyaya yazma, commit etme veya çıktıda gösterme.

## Arama

```bash
node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 8 --deep
node {baseDir}/scripts/search.mjs "query" --topic news --days 3
```

## URL içerik çıkarma

```bash
node {baseDir}/scripts/extract.mjs "https://example.com/article"
node {baseDir}/scripts/extract.mjs "https://a.com" "https://b.com"
```

## Güvenlik kuralları

- Sadece `http` / `https` URL kabul et.
- Localhost, loopback, private IP ve `.local/.internal` alan adlarını reddet.
- Tek istekte URL sayısını sınırlı tut (script varsayılanı uygular).
- Hata durumunda kısa ve temiz hata ver; anahtar veya hassas veri dökme.