Web Search Skills

License: MIT

A collection of web search tools and skills for AI agents, designed to enhance search capabilities with customizable configurations, multiple search engines support, and intelligent result processing.

Features

  • Multi-Engine Support — Built-in support for Google, Bing, DuckDuckGo, and custom search backends
  • Intelligent Result Processing — Extract, summarize, and rank search results automatically
  • Configurable Filters — Filter by date, domain, language, region, and content type
  • Async & Concurrent — Non-blocking requests with concurrent search execution
  • Extensible Architecture — Plugin-based design for easy integration of new search sources
  • Agent-Ready — Designed as a CodeBuddy Agent Skill for seamless AI integration

Getting Started

Prerequisites

  • Python 3.8+
  • pip / poetry

Installation

git clone https://github.com/openbot-coder/web-search-skills.git
cd web-search-skills
pip install -r requirements.txt

Quick Start

import asyncio
from src.web_search import search_web

results = asyncio.run(search_web("latest AI developments"))
for result in results:
    print(f"- {result.title}: {result.url}")

Project Structure

web-search-skills/
├── README.md              # Project documentation
├── LICENSE                # MIT License
├── skill.md               # CodeBuddy Agent Skill definition
├── requirements.txt       # Python dependencies
├── src/                   # Source code
│   └── web_search.py      # Core search implementation
└── examples/              # Usage examples
    └── basic_search.py

Usage

As a CodeBuddy Agent Skill

This project is designed as a CodeBuddy Agent Skill. To install:

  1. Copy skill.md to your CodeBuddy skills directory
  2. Configure your search engine API keys
  3. The skill is now available to your AI agent

API Reference

# Core class
searcher = WebSearch(config=None)
results = await searcher.search(query, engine="duckduckgo", max_results=10)
content = await searcher.extract_content(url)

# Convenience function
results = await search_web(query, engine="duckduckgo", max_results=10)

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes
  4. Push to the branch
  5. Open a Pull Request

License

This project is licensed under the MIT License — see the LICENSE file for details.

Acknowledgments

  • Built for the CodeBuddy ecosystem
  • Inspired by the need for better web search capabilities in AI agents
S
Description
A collection of web search tools and skills for enhancing search capabilities
Readme
136 KiB
0 Stars 3 Watchers 0 Forks
Languages
Python 100%