AI 驱动的全能搜索研究平台

report_id: CLS-2026-0505-TSP-83
report_date: "2026-05-04T19:49:58Z"
scanner_version: CLS-Certify v2.1.0
scan_mode: T-LITE Full Scan
skill_name: tavily-search-pro
skill_version: 1.0.0
skill_path: /tmp/bss_skill_vujrusdg
maintainer: shaharsha
license: unknown
scan_duration: 45.2s
code_stats: 576 lines · 4 files
trust_level: T2
trust_level_text: 可信组织/GitHub组织账号
total_风险发现: 3
grade: S
score: 83
evaluation: 优秀安全级别。该Skill代码结构清晰，无危险函数调用，使用标准库进行HTTPS通信，无硬编码敏感信息，依赖单一且可控，符合安全使用标准。
stamp_color: green
sample_hash: sha256:0e9711d2429def3addea019dbcf5e08d4ddda533370ba072e2922958aea7ad07
disclaimer: 认证结果不代表绝对安全保证，仅基于静态分析和代码审查。建议用户在使用前进行二次验证，并关注依赖包的更新和安全公告。
radar:

• name: 静态分析
  short: SA
  score: 85
  status: pass
  detail: 无eval/exec/system等危险函数，代码结构清晰，使用标准库urllib
• name: 动态行为
  short: DB
  score: 82
  status: pass
  detail: HTTPS请求至api.tavily.com，配置30s/120s超时，无非授权文件访问
• name: 依赖审计
  short: DA
  score: 85
  status: pass
  detail: 单一外部依赖tavily-python，无已知CVE漏洞
• name: 网络分析
  short: NA
  score: 88
  status: pass
  detail: 仅访问api.tavily.com官方API，HTTPS加密传输，无可疑域名
• name: 隐私合规
  short: PC
  score: 78
  status: warn
  detail: 读取TAVILY_API_KEY环境变量，用户查询发送至第三方API，建议查阅Tavily隐私政策
• name: 威胁情报
  short: TI
  score: 86
  status: pass
  detail: 无已知恶意模式匹配，代码行为与声明功能一致，无可疑URL

compliance:

• text: GDPR数据最小化原则
  status: pass
• text: 无硬编码敏感凭证
  status: pass
• text: 安全通信(TLS)
  status: pass
• text: 输入验证
  status: warn
• text: 依赖安全
  status: pass
• text: 功能行为一致性
  status: pass

风险模式

• info: Tavily Search API客户端
• info: 网络搜索工具
• low: pip --break-system-packages 降级方案
• info: 标准库urllib使用
• info: 环境变量API密钥读取

分析摘要

1. 代码结构安全：该Skill使用Python标准库urllib实现HTTP通信，无eval/exec/system/child_process等危险函数调用，代码逻辑清晰且易于审计。
2. 无硬编码敏感信息：API密钥通过环境变量TAVILY_API_KEY读取，代码中未发现硬编码的密码、Token或私钥。
3. 外部API调用可控：仅向api.tavily.com发起HTTPS请求，使用标准的Authorization Bearer认证，无数据外泄风险。
4. 依赖管理良好：仅依赖tavily-python官方SDK，无复杂的依赖树，降低了供应链攻击面。
5. 隐私合规需注意：用户搜索查询和提取的URL内容会发送至Tavily服务器，建议用户查阅Tavily隐私政策了解数据处理条款。

外部接口

风险发现

RISK-001

severity: low
category: dependency_management
title: install.sh使用--break-system-packages降级方案
location: install.sh:9
description: 安装脚本在标准pip安装失败时会尝试使用--break-system-packages标志。虽然这是为了兼容某些Python环境，但该标志会绕过系统包保护机制，可能导致系统Python环境不稳定。
recommendation: 建议使用虚拟环境(venv)或conda进行隔离安装，避免修改系统Python环境。可在安装脚本中优先尝试pip install --user或提示用户创建虚拟环境。

RISK-002

severity: low
category: input_validation
title: 缺少URL输入验证
location: lib/tavily_search.py:cmd_extract(), cmd_crawl()
description: extract和crawl命令接收用户提供的URL直接传递给API，代码层面未对URL格式进行验证（如协议限制、非法字符过滤）。虽然Tavily API会进行服务端验证，但客户端预验证可提升用户体验和安全性。
recommendation: 添加URL格式验证，确保输入以http://或https://开头，过滤控制字符和空白字符，限制URL长度（如不超过2048字符）。

RISK-003

severity: info
category: privacy_compliance
title: 第三方API服务数据共享
location: lib/tavily_search.py:_api_request()
description: 用户通过该Skill发起的所有搜索查询、URL提取内容和网站爬取指令都会发送至Tavily服务器处理。这涉及用户搜索意图和内容数据的第三方共享，需符合相关隐私法规要求。
recommendation: 在SKILL.md文档中添加隐私政策说明，告知用户数据将被发送至Tavily API处理。建议用户查阅https://tavily.com/privacy了解具体的数据收集、存储和使用政策。

改进建议

1. 改进安装脚本安全性

描述: 修改install.sh以优先使用用户级安装或虚拟环境，避免依赖--break-system-packages。

建议实现:

# 优先尝试用户级安装
pip install --user tavily-python 2>/dev/null || {
    # 提示用户创建虚拟环境
    echo "建议创建虚拟环境: python3 -m venv ~/.venv/tavily && source ~/.venv/tavily/bin/activate"
    pip install tavily-python
}

2. 添加输入验证层

描述: 在接收用户输入的URL和查询参数处添加验证逻辑，防止非法输入。

建议实现:

import re
from urllib.parse import urlparse

def validate_url(url: str) -> bool:
    """验证URL格式是否合法"""
    if not url or len(url) > 2048:
        return False
    parsed = urlparse(url)
    return parsed.scheme in ('http', 'https') and bool(parsed.netloc)

def sanitize_query(query: str) -> str:
    """清理查询字符串"""
    # 移除控制字符，限制长度
    return re.sub(r'[\x00-\x1f\x7f]', '', query[:1000])

3. 添加重试机制

描述: 为API调用添加指数退避重试机制，提升在网络波动情况下的稳定性。

建议实现:

import time
from functools import wraps

def retry_with_backoff(max_retries=3, base_delay=1):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            for attempt in range(max_retries):
                try:
                    return func(*args, **kwargs)
                except urllib.error.URLError as e:
                    if attempt == max_retries - 1:
                        raise
                    time.sleep(base_delay * (2 ** attempt))
            return func(*args, **kwargs)
        return wrapper
    return decorator

4. 完善隐私文档

描述: 在SKILL.md中添加隐私和数据处理说明章节，帮助用户了解数据去向。

建议内容:

## 隐私与数据安全

本Skill通过Tavily API进行网络搜索和内容提取。使用过程中：
- 您的搜索查询将发送至Tavily服务器
- 提取的URL内容将由Tavily处理
- 需要有效的Tavily API密钥

请参阅[Tavily隐私政策](https://tavily.com/privacy)了解详细的数据处理方式。