Give your AI Agent eyes to see the entire internet. Search + Read 10+ platforms.
Project description
🔍 Agent Search
Give your AI Agent instant access to the internet
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 |
| 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
Installation
pip install agent-search-tool
Supported Platforms
| Platform | Search | Read | Auth Required |
|---|---|---|---|
| Web | ✅ | ✅ | No |
| GitHub | ✅ | ✅ | Optional |
| ✅ | ✅ | No | |
| YouTube | ❌ | ✅ (transcript) | No |
| Twitter/X | ✅ | ✅ | Cookie |
| ❌ | ✅ | Cookie | |
| Bilibili | ✅ | ✅ | Cookie |
| Exa Search | ✅ | ✅ | API key |
| RSS | ❌ | ✅ | No |
| V2EX | ✅ | ✅ | No |
Usage
# Check what's working
agent-search doctor
# Search the web
agent-search search "latest LLM benchmarks 2026"
# Configure optional channels
agent-search configure
Setting Up Twitter/X
Twitter search requires browser cookies. Two ways to set it up:
Option 1 — Auto-extract from your local browser (fastest):
agent-search configure --from-browser chrome
Automatically pulls Twitter cookies from Chrome. Also works with Firefox, Edge, Brave.
Option 2 — Manual via Cookie-Editor:
- Log into x.com in Chrome
- Install the Cookie-Editor extension
- Click the extension → Export → Header String
- Run:
agent-search configure twitter-cookies "PASTE_COOKIE_STRING_HERE"
Once configured:
twitter search "AI agents 2026" -n 10
twitter read https://x.com/username/status/123456789
Setting Up LinkedIn
LinkedIn uses cookie-based auth via browser automation:
Option 1 — Auto-extract:
agent-search configure --from-browser chrome
Option 2 — Manual via Cookie-Editor:
- Log into linkedin.com in Chrome
- Cookie-Editor → Export → Header String
- Run:
agent-search configure linkedin-cookies "PASTE_COOKIE_STRING_HERE"
Setting Up Other Platforms
| Platform | Command |
|---|---|
Works out of the box — rdt search "query" |
|
| YouTube | Works out of the box — yt-dlp --dump-json URL |
| GitHub | Works out of the box — gh repo view owner/repo |
| Web | Works out of the box — curl https://r.jina.ai/URL |
| Exa Search | agent-search configure exa-key YOUR_KEY |
| Bilibili | agent-search configure --from-browser chrome |
| Xiaoyuzhou Podcast | agent-search configure groq-key gsk_... |
Run a Health Check
agent-search doctor
Shows which channels are ready and exactly what to run to fix anything that isn't.
Security
No hardcoded credentials. All cookies and API keys are stored in ~/.agent-search/config.yaml with 0600 permissions (owner read/write only). Credentials never leave your machine.
License
MIT — Copyright (c) 2026 Travis Burmaster
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_search_tool-1.4.8.tar.gz.
File metadata
- Download URL: agent_search_tool-1.4.8.tar.gz
- Upload date:
- Size: 68.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a68f10abd003d9c874eb02cab648ed164636b21d8666234c6d721ab28a692899
|
|
| MD5 |
66a6b27bd405bf4a082787749f002e8c
|
|
| BLAKE2b-256 |
79ac42b3b9c3aacb513a4ca402b662ef2d9d4f9f4805aa86e214ea3bed3bdc0e
|
File details
Details for the file agent_search_tool-1.4.8-py3-none-any.whl.
File metadata
- Download URL: agent_search_tool-1.4.8-py3-none-any.whl
- Upload date:
- Size: 72.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
750be16a619f3a3c885d60480b43bc3ddfe8713cee24f507be85cd02abf9362a
|
|
| MD5 |
e4d356c47412cbc494923ac7dfbb7282
|
|
| BLAKE2b-256 |
7a9db80fe9685f0706611b44ad204ba50c47fb10659cc776a87c9f1c6c03ad12
|