valkryhx/google_adk_agent / skills/web-search
web-search
VerifiedPerform web searches and extract content from URLs using the Tavily API. Use this skill to find real-time information, news, or deep-dive into specific web pages.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.7 KB |
| assets/example_asset.txt | markdown | 865 B |
| references/api_reference.md | markdown | 961 B |
| requirements.txt | manifest | 21 B |
| scripts/example.py | script | 579 B |
| scripts/search.py | script | 3.3 KB |
scripts/search.py
View on GitHub#!/usr/bin/env python3
"""
Web Search & Extraction Script using Tavily API.
Reads API Key from private_key.yaml in the project root.
"""
import argparse
import json
import os
import sys
import yaml
from pathlib import Path
# Force UTF-8 encoding for stdout to handle non-ASCII characters on Windows
sys.stdout.reconfigure(encoding='utf-8')
# Try to import TavilyClient, handle missing dependency
try:
from tavily import TavilyClient
except ImportError:
print(json.dumps({
"error": "Missing dependency 'tavily-python'. Please install it using: pip install tavily-python"
}))
sys.exit(1)
def load_api_key():
"""Load Tavily API Key from private_key.yaml."""
# Find project root (assuming script is deep in skills/...)
# Current script path: skills/web-search/scripts/search.py
# Project root is 4 levels up
# Robustly find private_key.yaml by walking up from the script location
current_path = Path(__file__).resolve()
for parent in [current_path] + list(current_path.parents):
config_path = parent / "private_key.yaml"
if config_path.exists():
try:
with open(config_path, 'r', encoding='utf-8') as f:
config = yaml.safe_load(f)
return config.get("tavily_api_key")
except Exception:
return None
return None
API_KEY = load_api_key() or os.environ.get("TAVILY_API_KEY")
def search(query, depth="basic", include_answer=False, include_raw_content=False):
"""Perform a web search."""
if not API_KEY:
return {"error": "TAVILY_API_KEY not found in private_key.yaml or environment variables."}
client = TavilyClient(api_key=API_KEY)
try:
response = client.search(
query=query,
search_depth=depth,
include_answer=include_answer,
include_raw_content=include_raw_content
)
return response
except Exception as e:
return {"error": str(e)}
def extract(url):
"""Extract content from a URL."""
if not API_KEY:
return {"error": "TAVILY_API_KEY not found in private_key.yaml or environment variables."}
client = TavilyClient(api_key=API_KEY)
try:
response = client.extract(urls=[url])
return response
except Exception as e:
return {"error": str(e)}
def main():
parser = argparse.ArgumentParser(description="Web Search and Extraction Tool")
group = parser.add_mutually_exclusive_group(required=True)
group.add_argument("--query", help="Search query")
group.add_argument("--url", help="URL to extract content from")
parser.add_argument("--depth", choices=["basic", "advanced"], default="basic", help="Search depth")
parser.add_argument("--include-answer", action="store_true", help="Include generated answer")
parser.add_argument("--include-raw-content", action="store_true", help="Include raw content")
args = parser.parse_args()
if args.query:
result = search(
query=args.query,
depth=args.depth,
include_answer=args.include_answer,
include_raw_content=args.include_raw_content
)
elif args.url:
result = extract(url=args.url)
# Print JSON output for the agent to parse
print(json.dumps(result, indent=2, ensure_ascii=False))
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |