[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77KEXKX9BWBZ1K256Q4WDZ6":3,"skill-same:01M77KEXKX9BWBZ1K256Q4WDZ6":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M77KEXKX9BWBZ1K256Q4WDZ6","web-search",null,"This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses SkillBoss API Hub to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fk\u002Fkirk-web-search\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: web-search\ndescription: This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses SkillBoss API Hub to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.\nrequires.env: [SKILLBOSS_API_KEY]\n---\n\n# Web Search\n\n## Overview\n\nSearch the web using SkillBoss API Hub to find information across web pages, news articles, images, and videos. Returns results in multiple formats (text, markdown, JSON) with filtering options for time range, region, and safe search.\n\n## When to Use This Skill\n\nUse this skill when users request:\n- Web searches for information or resources\n- Finding current or recent information online\n- Looking up news articles about specific topics\n- Searching for images by description or topic\n- Finding videos on specific subjects\n- Research requiring current web data\n- Fact-checking or verification using web sources\n- Gathering URLs and resources on a topic\n\n## Prerequisites\n\nInstall the required dependency:\n\n```bash\npip install requests\n```\n\nSet your SkillBoss API Hub key as an environment variable:\n\n```bash\nexport SKILLBOSS_API_KEY=your_skillboss_api_key\n```\n\nSkillBoss API Hub provides unified access to web search and other AI capabilities through a single endpoint — no additional service-specific API keys required.\n\n## Core Capabilities\n\n### 1. Basic Web Search\n\nSearch for web pages and information:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\"\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"python asyncio tutorial\"\n```\n\nReturns the top 10 web results with titles, URLs, and descriptions in a clean text format.\n\n### 2. Limiting Results\n\nControl the number of results returned:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --max-results \u003CN>\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"machine learning frameworks\" --max-results 20\n```\n\nUseful for:\n- Getting more comprehensive results (increase limit)\n- Quick lookups with fewer results (decrease limit)\n- Balancing detail vs. processing time\n\n### 3. Time Range Filtering\n\nFilter results by recency:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --time-range \u003Cd|w|m|y>\n```\n\n**Time range options:**\n- `d` - Past day\n- `w` - Past week\n- `m` - Past month\n- `y` - Past year\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"artificial intelligence news\" --time-range w\n```\n\nGreat for:\n- Finding recent news or updates\n- Filtering out outdated content\n- Tracking recent developments\n\n### 4. News Search\n\nSearch specifically for news articles:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --type news\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"climate change\" --type news --time-range w --max-results 15\n```\n\nNews results include:\n- Article title\n- Source publication\n- Publication date\n- URL\n- Article summary\u002Fdescription\n\n### 5. Image Search\n\nSearch for images:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --type images\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"sunset over mountains\" --type images --max-results 20\n```\n\n**Image filtering options:**\n\nSize filters:\n```bash\npython scripts\u002Fsearch.py \"landscape photos\" --type images --image-size Large\n```\nOptions: `Small`, `Medium`, `Large`, `Wallpaper`\n\nColor filters:\n```bash\npython scripts\u002Fsearch.py \"abstract art\" --type images --image-color Blue\n```\nOptions: `color`, `Monochrome`, `Red`, `Orange`, `Yellow`, `Green`, `Blue`, `Purple`, `Pink`, `Brown`, `Black`, `Gray`, `Teal`, `White`\n\nType filters:\n```bash\npython scripts\u002Fsearch.py \"icons\" --type images --image-type transparent\n```\nOptions: `photo`, `clipart`, `gif`, `transparent`, `line`\n\nLayout filters:\n```bash\npython scripts\u002Fsearch.py \"wallpapers\" --type images --image-layout Wide\n```\nOptions: `Square`, `Tall`, `Wide`\n\nImage results include:\n- Image title\n- Image URL (direct link to image)\n- Thumbnail URL\n- Source website\n- Dimensions (width x height)\n\n### 6. Video Search\n\nSearch for videos:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --type videos\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"python tutorial\" --type videos --max-results 15\n```\n\n**Video filtering options:**\n\nDuration filters:\n```bash\npython scripts\u002Fsearch.py \"cooking recipes\" --type videos --video-duration short\n```\nOptions: `short`, `medium`, `long`\n\nResolution filters:\n```bash\npython scripts\u002Fsearch.py \"documentary\" --type videos --video-resolution high\n```\nOptions: `high`, `standard`\n\nVideo results include:\n- Video title\n- Publisher\u002Fchannel\n- Duration\n- Publication date\n- Video URL\n- Description\n\n### 7. Region-Specific Search\n\nSearch with region-specific results:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --region \u003Cregion-code>\n```\n\n**Common region codes:**\n- `us-en` - United States (English)\n- `uk-en` - United Kingdom (English)\n- `ca-en` - Canada (English)\n- `au-en` - Australia (English)\n- `de-de` - Germany (German)\n- `fr-fr` - France (French)\n- `wt-wt` - Worldwide (default)\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"local news\" --region us-en --type news\n```\n\n### 8. Safe Search Control\n\nControl safe search filtering:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --safe-search \u003Con|moderate|off>\n```\n\n**Options:**\n- `on` - Strict filtering\n- `moderate` - Balanced filtering (default)\n- `off` - No filtering\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"medical information\" --safe-search on\n```\n\n### 9. Output Formats\n\nChoose how results are formatted:\n\n**Text format (default):**\n```bash\npython scripts\u002Fsearch.py \"quantum computing\"\n```\n\nClean, readable plain text with numbered results.\n\n**Markdown format:**\n```bash\npython scripts\u002Fsearch.py \"quantum computing\" --format markdown\n```\n\nFormatted markdown with headers, bold text, and links.\n\n**JSON format:**\n```bash\npython scripts\u002Fsearch.py \"quantum computing\" --format json\n```\n\nStructured JSON data for programmatic processing.\n\n### 10. Saving Results to File\n\nSave search results to a file:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --output \u003Cfile-path>\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"artificial intelligence\" --output ai_results.txt\npython scripts\u002Fsearch.py \"AI news\" --type news --format markdown --output ai_news.md\npython scripts\u002Fsearch.py \"AI research\" --format json --output ai_data.json\n```\n\nThe file format is determined by the `--format` flag, not the file extension.\n\n## Output Format Examples\n\n### Text Format\n```\n1. Page Title Here\n   URL: https:\u002F\u002Fexample.com\u002Fpage\n   Brief description of the page content...\n\n2. Another Result\n   URL: https:\u002F\u002Fexample.com\u002Fanother\n   Another description...\n```\n\n### Markdown Format\n```markdown\n## 1. Page Title Here\n\n**URL:** https:\u002F\u002Fexample.com\u002Fpage\n\nBrief description of the page content...\n\n## 2. Another Result\n\n**URL:** https:\u002F\u002Fexample.com\u002Fanother\n\nAnother description...\n```\n\n### JSON Format\n```json\n[\n  {\n    \"title\": \"Page Title Here\",\n    \"href\": \"https:\u002F\u002Fexample.com\u002Fpage\",\n    \"body\": \"Brief description of the page content...\"\n  },\n  {\n    \"title\": \"Another Result\",\n    \"href\": \"https:\u002F\u002Fexample.com\u002Fanother\",\n    \"body\": \"Another description...\"\n  }\n]\n```\n\n## Common Usage Patterns\n\n### Research on a Topic\n\nGather comprehensive information about a subject:\n\n```bash\n# Get overview from web\npython scripts\u002Fsearch.py \"machine learning basics\" --max-results 15 --output ml_web.txt\n\n# Get recent news\npython scripts\u002Fsearch.py \"machine learning\" --type news --time-range m --output ml_news.txt\n\n# Find tutorial videos\npython scripts\u002Fsearch.py \"machine learning tutorial\" --type videos --max-results 10 --output ml_videos.txt\n```\n\n### Current Events Monitoring\n\nTrack news on specific topics:\n\n```bash\npython scripts\u002Fsearch.py \"climate summit\" --type news --time-range d --format markdown --output daily_climate_news.md\n```\n\n### Finding Visual Resources\n\nSearch for images with specific criteria:\n\n```bash\npython scripts\u002Fsearch.py \"data visualization examples\" --type images --image-type photo --image-size Large --max-results 25 --output viz_images.txt\n```\n\n### Fact-Checking\n\nVerify information with recent sources:\n\n```bash\npython scripts\u002Fsearch.py \"specific claim to verify\" --time-range w --max-results 20\n```\n\n### Academic Research\n\nFind resources on scholarly topics:\n\n```bash\npython scripts\u002Fsearch.py \"quantum entanglement research\" --time-range y --max-results 30 --output quantum_research.txt\n```\n\n### Market Research\n\nGather information about products or companies:\n\n```bash\npython scripts\u002Fsearch.py \"electric vehicle market 2025\" --max-results 20 --format markdown --output ev_market.md\npython scripts\u002Fsearch.py \"EV news\" --type news --time-range m --output ev_news.txt\n```\n\n## Implementation Approach\n\nWhen users request web searches:\n\n1. **Identify search intent**:\n   - What type of content (web, news, images, videos)?\n   - How recent should results be?\n   - How many results are needed?\n   - Any filtering requirements?\n\n2. **Configure search parameters**:\n   - Choose appropriate search type (`--type`)\n   - Set time range if currency matters (`--time-range`)\n   - Adjust result count (`--max-results`)\n   - Apply filters (image size, video duration, etc.)\n\n3. **Select output format**:\n   - Text for quick reading\n   - Markdown for documentation\n   - JSON for further processing\n\n4. **Execute search**:\n   - Run the search command\n   - Save to file if results need to be preserved\n   - Print to stdout for immediate review\n\n5. **Process results**:\n   - Read saved files if needed\n   - Extract URLs or specific information\n   - Combine results from multiple searches\n\n## Quick Reference\n\n**Command structure:**\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" [options]\n```\n\n**Essential options:**\n- `-t, --type` - Search type (web, news, images, videos)\n- `-n, --max-results` - Maximum results (default: 10)\n- `--time-range` - Time filter (d, w, m, y)\n- `-r, --region` - Region code (e.g., us-en, uk-en)\n- `--safe-search` - Safe search level (on, moderate, off)\n- `-f, --format` - Output format (text, markdown, json)\n- `-o, --output` - Save to file\n\n**Image-specific options:**\n- `--image-size` - Size filter (Small, Medium, Large, Wallpaper)\n- `--image-color` - Color filter\n- `--image-type` - Type filter (photo, clipart, gif, transparent, line)\n- `--image-layout` - Layout filter (Square, Tall, Wide)\n\n**Video-specific options:**\n- `--video-duration` - Duration filter (short, medium, long)\n- `--video-resolution` - Resolution filter (high, standard)\n\n**Get full help:**\n```bash\npython scripts\u002Fsearch.py --help\n```\n\n## Best Practices\n\n1. **Be specific** - Use clear, specific search queries for better results\n2. **Use time filters** - Apply `--time-range` for current information\n3. **Adjust result count** - Start with 10-20 results, increase if needed\n4. **Save important searches** - Use `--output` to preserve results\n5. **Choose appropriate type** - Use news search for current events, web for general info\n6. **Use JSON for automation** - JSON format is easiest to parse programmatically\n7. **Respect usage** - Don't hammer the API with rapid repeated searches\n\n## Troubleshooting\n\n**Common issues:**\n\n- **\"SKILLBOSS_API_KEY not set\"**: Export your key with `export SKILLBOSS_API_KEY=your_key`\n- **No results found**: Try broader search terms or remove time filters\n- **Timeout errors**: The search service may be temporarily unavailable; retry after a moment\n- **Rate limiting**: Space out searches if making many requests\n- **Unexpected results**: Try refining the query or adjusting search type\n\n**Limitations:**\n\n- Results quality depends on SkillBoss API Hub's routing and underlying search providers\n- Image and video searches may have fewer results than web search\n- Some specialized searches may work better with more specific queries\n\n## Advanced Use Cases\n\n### Combining Multiple Searches\n\nGather comprehensive information by combining search types:\n\n```bash\n# Web overview\npython scripts\u002Fsearch.py \"topic\" --max-results 15 --output topic_web.txt\n\n# Recent news\npython scripts\u002Fsearch.py \"topic\" --type news --time-range w --output topic_news.txt\n\n# Images\npython scripts\u002Fsearch.py \"topic\" --type images --max-results 20 --output topic_images.txt\n```\n\n### Programmatic Processing\n\nUse JSON output for automated processing:\n\n```bash\npython scripts\u002Fsearch.py \"research topic\" --format json --output results.json\n# Then process with another script\npython analyze_results.py results.json\n```\n\n### Building a Knowledge Base\n\nCreate searchable documentation from web results:\n\n```bash\n# Search multiple related topics\npython scripts\u002Fsearch.py \"topic1\" --format markdown --output kb\u002Ftopic1.md\npython scripts\u002Fsearch.py \"topic2\" --format markdown --output kb\u002Ftopic2.md\npython scripts\u002Fsearch.py \"topic3\" --format markdown --output kb\u002Ftopic3.md\n```\n\n## Resources\n\n### scripts\u002Fsearch.py\n\nThe main search tool implementing web search functionality via SkillBoss API Hub. Key features:\n\n- **Multiple search types** - Web, news, images, and videos\n- **Flexible filtering** - Time range, region, safe search, and type-specific filters\n- **Multiple output formats** - Text, Markdown, and JSON\n- **File output** - Save results for later processing\n- **Clean formatting** - Human-readable output with all essential information\n- **Error handling** - Graceful handling of network errors and empty results\n\nThe script can be executed directly and includes comprehensive command-line help via `--help`.\n","# Web Search\n\n## Overview\n\nSearch the web using SkillBoss API Hub to find information across web pages, news articles, images, and videos. Returns results in multiple formats (text, markdown, JSON) with filtering options for time range, region, and safe search.\n\n## When to Use This Skill\n\nUse this skill when users request:\n- Web searches for information or resources\n- Finding current or recent information online\n- Looking up news articles about specific topics\n- Searching for images by description or topic\n- Finding videos on specific subjects\n- Research requiring current web data\n- Fact-checking or verification using web sources\n- Gathering URLs and resources on a topic\n\n## Prerequisites\n\nInstall the required dependency:\n\n```bash\npip install requests\n```\n\nSet your SkillBoss API Hub key as an environment variable:\n\n```bash\nexport SKILLBOSS_API_KEY=your_skillboss_api_key\n```\n\nSkillBoss API Hub provides unified access to web search and other AI capabilities through a single endpoint — no additional service-specific API keys required.\n\n## Core Capabilities\n\n### 1. Basic Web Search\n\nSearch for web pages and information:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\"\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"python asyncio tutorial\"\n```\n\nReturns the top 10 web results with titles, URLs, and descriptions in a clean text format.\n\n### 2. Limiting Results\n\nControl the number of results returned:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --max-results \u003CN>\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"machine learning frameworks\" --max-results 20\n```\n\nUseful for:\n- Getting more comprehensive results (increase limit)\n- Quick lookups with fewer results (decrease limit)\n- Balancing detail vs. processing time\n\n### 3. Time Range Filtering\n\nFilter results by recency:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --time-range \u003Cd|w|m|y>\n```\n\n**Time range options:**\n- `d` - Past day\n- `w` - Past week\n- `m` - Past month\n- `y` - Past year\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"artificial intelligence news\" --time-range w\n```\n\nGreat for:\n- Finding recent news or updates\n- Filtering out outdated content\n- Tracking recent developments\n\n### 4. News Search\n\nSearch specifically for news articles:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --type news\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"climate change\" --type news --time-range w --max-results 15\n```\n\nNews results include:\n- Article title\n- Source publication\n- Publication date\n- URL\n- Article summary\u002Fdescription\n\n### 5. Image Search\n\nSearch for images:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --type images\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"sunset over mountains\" --type images --max-results 20\n```\n\n**Image filtering options:**\n\nSize filters:\n```bash\npython scripts\u002Fsearch.py \"landscape photos\" --type images --image-size Large\n```\nOptions: `Small`, `Medium`, `Large`, `Wallpaper`\n\nColor filters:\n```bash\npython scripts\u002Fsearch.py \"abstract art\" --type images --image-color Blue\n```\nOptions: `color`, `Monochrome`, `Red`, `Orange`, `Yellow`, `Green`, `Blue`, `Purple`, `Pink`, `Brown`, `Black`, `Gray`, `Teal`, `White`\n\nType filters:\n```bash\npython scripts\u002Fsearch.py \"icons\" --type images --image-type transparent\n```\nOptions: `photo`, `clipart`, `gif`, `transparent`, `line`\n\nLayout filters:\n```bash\npython scripts\u002Fsearch.py \"wallpapers\" --type images --image-layout Wide\n```\nOptions: `Square`, `Tall`, `Wide`\n\nImage results include:\n- Image title\n- Image URL (direct link to image)\n- Thumbnail URL\n- Source website\n- Dimensions (width x height)\n\n### 6. Video Search\n\nSearch for videos:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --type videos\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"python tutorial\" --type videos --max-results 15\n```\n\n**Video filtering options:**\n\nDuration filters:\n```bash\npython scripts\u002Fsearch.py \"cooking recipes\" --type videos --video-duration short\n```\nOptions: `short`, `medium`, `long`\n\nResolution filters:\n```bash\npython scripts\u002Fsearch.py \"documentary\" --type videos --video-resolution high\n```\nOptions: `high`, `standard`\n\nVideo results include:\n- Video title\n- Publisher\u002Fchannel\n- Duration\n- Publication date\n- Video URL\n- Description\n\n### 7. Region-Specific Search\n\nSearch with region-specific results:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --region \u003Cregion-code>\n```\n\n**Common region codes:**\n- `us-en` - United States (English)\n- `uk-en` - United Kingdom (English)\n- `ca-en` - Canada (English)\n- `au-en` - Australia (English)\n- `de-de` - Germany (German)\n- `fr-fr` - France (French)\n- `wt-wt` - Worldwide (default)\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"local news\" --region us-en --type news\n```\n\n### 8. Safe Search Control\n\nControl safe search filtering:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --safe-search \u003Con|moderate|off>\n```\n\n**Options:**\n- `on` - Strict filtering\n- `moderate` - Balanced filtering (default)\n- `off` - No filtering\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"medical information\" --safe-search on\n```\n\n### 9. Output Formats\n\nChoose how results are formatted:\n\n**Text format (default):**\n```bash\npython scripts\u002Fsearch.py \"quantum computing\"\n```\n\nClean, readable plain text with numbered results.\n\n**Markdown format:**\n```bash\npython scripts\u002Fsearch.py \"quantum computing\" --format markdown\n```\n\nFormatted markdown with headers, bold text, and links.\n\n**JSON format:**\n```bash\npython scripts\u002Fsearch.py \"quantum computing\" --format json\n```\n\nStructured JSON data for programmatic processing.\n\n### 10. Saving Results to File\n\nSave search results to a file:\n\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" --output \u003Cfile-path>\n```\n\n**Example:**\n```bash\npython scripts\u002Fsearch.py \"artificial intelligence\" --output ai_results.txt\npython scripts\u002Fsearch.py \"AI news\" --type news --format markdown --output ai_news.md\npython scripts\u002Fsearch.py \"AI research\" --format json --output ai_data.json\n```\n\nThe file format is determined by the `--format` flag, not the file extension.\n\n## Output Format Examples\n\n### Text Format\n```\n1. Page Title Here\n   URL: https:\u002F\u002Fexample.com\u002Fpage\n   Brief description of the page content...\n\n2. Another Result\n   URL: https:\u002F\u002Fexample.com\u002Fanother\n   Another description...\n```\n\n### Markdown Format\n```markdown\n## 1. Page Title Here\n\n**URL:** https:\u002F\u002Fexample.com\u002Fpage\n\nBrief description of the page content...\n\n## 2. Another Result\n\n**URL:** https:\u002F\u002Fexample.com\u002Fanother\n\nAnother description...\n```\n\n### JSON Format\n```json\n[\n  {\n    \"title\": \"Page Title Here\",\n    \"href\": \"https:\u002F\u002Fexample.com\u002Fpage\",\n    \"body\": \"Brief description of the page content...\"\n  },\n  {\n    \"title\": \"Another Result\",\n    \"href\": \"https:\u002F\u002Fexample.com\u002Fanother\",\n    \"body\": \"Another description...\"\n  }\n]\n```\n\n## Common Usage Patterns\n\n### Research on a Topic\n\nGather comprehensive information about a subject:\n\n```bash\n# Get overview from web\npython scripts\u002Fsearch.py \"machine learning basics\" --max-results 15 --output ml_web.txt\n\n# Get recent news\npython scripts\u002Fsearch.py \"machine learning\" --type news --time-range m --output ml_news.txt\n\n# Find tutorial videos\npython scripts\u002Fsearch.py \"machine learning tutorial\" --type videos --max-results 10 --output ml_videos.txt\n```\n\n### Current Events Monitoring\n\nTrack news on specific topics:\n\n```bash\npython scripts\u002Fsearch.py \"climate summit\" --type news --time-range d --format markdown --output daily_climate_news.md\n```\n\n### Finding Visual Resources\n\nSearch for images with specific criteria:\n\n```bash\npython scripts\u002Fsearch.py \"data visualization examples\" --type images --image-type photo --image-size Large --max-results 25 --output viz_images.txt\n```\n\n### Fact-Checking\n\nVerify information with recent sources:\n\n```bash\npython scripts\u002Fsearch.py \"specific claim to verify\" --time-range w --max-results 20\n```\n\n### Academic Research\n\nFind resources on scholarly topics:\n\n```bash\npython scripts\u002Fsearch.py \"quantum entanglement research\" --time-range y --max-results 30 --output quantum_research.txt\n```\n\n### Market Research\n\nGather information about products or companies:\n\n```bash\npython scripts\u002Fsearch.py \"electric vehicle market 2025\" --max-results 20 --format markdown --output ev_market.md\npython scripts\u002Fsearch.py \"EV news\" --type news --time-range m --output ev_news.txt\n```\n\n## Implementation Approach\n\nWhen users request web searches:\n\n1. **Identify search intent**:\n   - What type of content (web, news, images, videos)?\n   - How recent should results be?\n   - How many results are needed?\n   - Any filtering requirements?\n\n2. **Configure search parameters**:\n   - Choose appropriate search type (`--type`)\n   - Set time range if currency matters (`--time-range`)\n   - Adjust result count (`--max-results`)\n   - Apply filters (image size, video duration, etc.)\n\n3. **Select output format**:\n   - Text for quick reading\n   - Markdown for documentation\n   - JSON for further processing\n\n4. **Execute search**:\n   - Run the search command\n   - Save to file if results need to be preserved\n   - Print to stdout for immediate review\n\n5. **Process results**:\n   - Read saved files if needed\n   - Extract URLs or specific information\n   - Combine results from multiple searches\n\n## Quick Reference\n\n**Command structure:**\n```bash\npython scripts\u002Fsearch.py \"\u003Cquery>\" [options]\n```\n\n**Essential options:**\n- `-t, --type` - Search type (web, news, images, videos)\n- `-n, --max-results` - Maximum results (default: 10)\n- `--time-range` - Time filter (d, w, m, y)\n- `-r, --region` - Region code (e.g., us-en, uk-en)\n- `--safe-search` - Safe search level (on, moderate, off)\n- `-f, --format` - Output format (text, markdown, json)\n- `-o, --output` - Save to file\n\n**Image-specific options:**\n- `--image-size` - Size filter (Small, Medium, Large, Wallpaper)\n- `--image-color` - Color filter\n- `--image-type` - Type filter (photo, clipart, gif, transparent, line)\n- `--image-layout` - Layout filter (Square, Tall, Wide)\n\n**Video-specific options:**\n- `--video-duration` - Duration filter (short, medium, long)\n- `--video-resolution` - Resolution filter (high, standard)\n\n**Get full help:**\n```bash\npython scripts\u002Fsearch.py --help\n```\n\n## Best Practices\n\n1. **Be specific** - Use clear, specific search queries for better results\n2. **Use time filters** - Apply `--time-range` for current information\n3. **Adjust result count** - Start with 10-20 results, increase if needed\n4. **Save important searches** - Use `--output` to preserve results\n5. **Choose appropriate type** - Use news search for current events, web for general info\n6. **Use JSON for automation** - JSON format is easiest to parse programmatically\n7. **Respect usage** - Don't hammer the API with rapid repeated searches\n\n## Troubleshooting\n\n**Common issues:**\n\n- **\"SKILLBOSS_API_KEY not set\"**: Export your key with `export SKILLBOSS_API_KEY=your_key`\n- **No results found**: Try broader search terms or remove time filters\n- **Timeout errors**: The search service may be temporarily unavailable; retry after a moment\n- **Rate limiting**: Space out searches if making many requests\n- **Unexpected results**: Try refining the query or adjusting search type\n\n**Limitations:**\n\n- Results quality depends on SkillBoss API Hub's routing and underlying search providers\n- Image and video searches may have fewer results than web search\n- Some specialized searches may work better with more specific queries\n\n## Advanced Use Cases\n\n### Combining Multiple Searches\n\nGather comprehensive information by combining search types:\n\n```bash\n# Web overview\npython scripts\u002Fsearch.py \"topic\" --max-results 15 --output topic_web.txt\n\n# Recent news\npython scripts\u002Fsearch.py \"topic\" --type news --time-range w --output topic_news.txt\n\n# Images\npython scripts\u002Fsearch.py \"topic\" --type images --max-results 20 --output topic_images.txt\n```\n\n### Programmatic Processing\n\nUse JSON output for automated processing:\n\n```bash\npython scripts\u002Fsearch.py \"research topic\" --format json --output results.json\n# Then process with another script\npython analyze_results.py results.json\n```\n\n### Building a Knowledge Base\n\nCreate searchable documentation from web results:\n\n```bash\n# Search multiple related topics\npython scripts\u002Fsearch.py \"topic1\" --format markdown --output kb\u002Ftopic1.md\npython scripts\u002Fsearch.py \"topic2\" --format markdown --output kb\u002Ftopic2.md\npython scripts\u002Fsearch.py \"topic3\" --format markdown --output kb\u002Ftopic3.md\n```\n\n## Resources\n\n### scripts\u002Fsearch.py\n\nThe main search tool implementing web search functionality via SkillBoss API Hub. Key features:\n\n- **Multiple search types** - Web, news, images, and videos\n- **Flexible filtering** - Time range, region, safe search, and type-specific filters\n- **Multiple output formats** - Text, Markdown, and JSON\n- **File output** - Save results for later processing\n- **Clean formatting** - Human-readable output with all essential information\n- **Error handling** - Graceful handling of network errors and empty results\n\nThe script can be executed directly and includes comprehensive command-line help via `--help`.\n",{"name":5,"description":7,"requires.env":24},[25],"SKILLBOSS_API_KEY","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fk\u002Fkirk-web-search",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill web-search",{"tool":41,"command":42},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill web-search",{"tool":44,"command":45},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill web-search","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fk\u002Fkirk-web-search\u002FSKILL.md",true,[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]