Skip to main content

🔍 Agent Search

Give your AI Agent instant access to the internet

MIT License Python 3.8+ GitHub Stars


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

Installation

pip install agent-search-tool

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

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:

  1. Log into x.com in Chrome
  2. Install the Cookie-Editor extension
  3. Click the extension → Export → Header String
  4. 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:

  1. Log into linkedin.com in Chrome
  2. Cookie-Editor → Export → Header String
  3. Run:
agent-search configure linkedin-cookies "PASTE_COOKIE_STRING_HERE"

Setting Up Other Platforms

Platform Command
Reddit 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

Metadata

Release files for agent-search-tool 1.4.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-search-tool 1.4.8
File Size Uploaded
agent_search_tool-1.4.8.tar.gz 68.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-search-tool 1.4.8
File Interpreter ABI Platform
agent_search_tool-1.4.8-py3-none-any.whl Python 3 none any Details

Total release size: 140.3 kB

Release files / agent_search_tool-1.4.8.tar.gz

Download URL agent_search_tool-1.4.8.tar.gz
Size 68.0 kB
Tags Source
SHA-256 checksum
How to use checksums
a68f10abd003d9c874eb02cab648ed164636b21d8666234c6d721ab28a692899
BLAKE2b-256 checksum
How to use checksums
79ac42b3b9c3aacb513a4ca402b662ef2d9d4f9f4805aa86e214ea3bed3bdc0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / agent_search_tool-1.4.8-py3-none-any.whl

Download URL agent_search_tool-1.4.8-py3-none-any.whl
Size 72.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
750be16a619f3a3c885d60480b43bc3ddfe8713cee24f507be85cd02abf9362a
BLAKE2b-256 checksum
How to use checksums
7a9db80fe9685f0706611b44ad204ba50c47fb10659cc776a87c9f1c6c03ad12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

1.4.8 This release

2 release files

1.4.7

2 release files

1.4.6

2 release files

1.4.5

2 release files

1.4.4

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

1 release file

1.4.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page