Metadata-Version: 2.4
Name: agent-search-tool
Version: 1.4.6
Summary: Give your AI Agent eyes to see the entire internet. Search + Read 10+ platforms.
Author-email: Travis Burmaster <travis@burmaster.com>
License: MIT
Project-URL: Homepage, https://github.com/Panniantong/agent-search
Project-URL: Repository, https://github.com/Panniantong/agent-search
Project-URL: Issues, https://github.com/Panniantong/agent-search/issues
Keywords: ai-agent,llm-tools,agent-infrastructure,mcp,web-reader,web-scraper,search,twitter-scraper,reddit-scraper,youtube-transcript,bilibili,xiaohongshu,ai-search,cli,automation,claude-code,cursor,openai,free-api,no-api-key
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28
Requires-Dist: feedparser>=6.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: loguru>=0.7
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: yt-dlp>=2024.0
Provides-Extra: browser
Requires-Dist: playwright>=1.40; extra == "browser"
Provides-Extra: cookies
Requires-Dist: browser-cookie3>=0.19; extra == "cookies"
Provides-Extra: all
Requires-Dist: playwright>=1.40; extra == "all"
Requires-Dist: mcp[cli]>=1.0; extra == "all"
Requires-Dist: browser-cookie3>=0.19; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: mypy>=1.12; extra == "dev"
Requires-Dist: types-requests>=2.32; extra == "dev"
Requires-Dist: types-PyYAML>=6.0; extra == "dev"
Dynamic: license-file

<h1 align="center">🔍 Agent Search</h1>

<p align="center">
  <strong>Give your AI Agent instant access to the internet</strong>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10+-green.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"></a>
  <a href="https://github.com/travis-burmaster/agent-search-tool/stargazers"><img src="https://img.shields.io/github/stars/travis-burmaster/agent-search-tool?style=for-the-badge" alt="GitHub Stars"></a>
</p>

---

## What is Agent Search?

Agent Search gives your AI agent the ability to search and read content from 10+ platforms — Twitter/X, Reddit, YouTube, GitHub, Bilibili, LinkedIn, web pages, and more — with a single install command.

**The problem it solves:**

| Pain Point | Reality |
|---|---|
| Twitter/X API | Paid, $215/mo for moderate use |
| Reddit | Server IPs get 403'd |
| YouTube transcripts | No official API |
| GitHub search | Auth required, rate limited |
| Web scraping | Returns raw HTML, not readable content |

Agent Search handles all of this transparently. Your agent calls a function, gets back clean readable text.

## Quick Start

Paste this into your AI agent (Claude Code, Cursor, OpenAI Assistants, etc.):

```
Install Agent Search: https://raw.githubusercontent.com/travis-burmaster/agent-search-tool/main/docs/install.md
```

## Supported Platforms

| Platform | Search | Read | Auth Required |
|---|---|---|---|
| Web | ✅ | ✅ | No |
| GitHub | ✅ | ✅ | Optional |
| Reddit | ✅ | ✅ | No |
| YouTube | ❌ | ✅ (transcript) | No |
| Twitter/X | ✅ | ✅ | Cookie |
| LinkedIn | ❌ | ✅ | Cookie |
| Bilibili | ✅ | ✅ | Cookie |
| Exa Search | ✅ | ✅ | API key |
| RSS | ❌ | ✅ | No |
| V2EX | ✅ | ✅ | No |

## Installation

```bash
pip install agent-search-tool
```

## Usage

```bash
# Check what's working
agent-search doctor

# Configure optional features
agent-search configure

# Search the web
agent-search search "latest LLM benchmarks 2026"

# Read a URL
agent-search read https://github.com/travis-burmaster/agent-search-tool
```

## Security

No hardcoded credentials. Cookies and API keys are stored in `~/.agent-search/config.yaml` with `0600` permissions (owner read/write only).

## License

MIT — Copyright (c) 2026 Travis Burmaster
