crewai-synoppy
Give your CrewAI agents the whole web. Synoppy tools for CrewAI — read, search, crawl, map, extract, classify, enrich, screenshot, and pull images from the live web, all on one key.
Get a free key → · Docs · synoppy.com
Install
pip install crewai-synoppy
Quickstart
from crewai import Agent, Task, Crew
from crewai_synoppy import synoppy_tools
tools = synoppy_tools(api_key="syn_live_...")
researcher = Agent(
role="Web researcher",
goal="Find and summarize current information from the web",
backstory="You use Synoppy to read and search the live web.",
tools=tools,
)
task = Task(description="Find the top HN story and summarize it in 3 bullets.", agent=researcher, expected_output="3 bullets")
print(Crew(agents=[researcher], tasks=[task]).kickoff())
synoppy_tools() returns a list of CrewAI BaseTools. Want a subset? Import the individual tool classes (SynoppyReadTool, SynoppySearchTool, …) and instantiate them with api_key=.
Tools
| Tool | Endpoint | What it does |
|---|---|---|
synoppy_read |
/api/scrape |
URL → clean markdown (nav/ads stripped) |
synoppy_search |
/api/search |
Ranked live-web results, optionally read to markdown |
synoppy_crawl |
/api/crawl |
Crawl a site → markdown per page (RAG ingest) |
synoppy_map |
/api/map |
Every URL on a domain |
synoppy_extract |
/api/extract |
Page → structured JSON from a prompt |
synoppy_classify |
/api/classify |
NAICS/SIC industry codes, or custom labels |
synoppy_enrich |
/api/brand |
Domain / email → brand profile (logo, colors, fonts, socials) |
synoppy_images |
/api/images |
Every image on a page + alt text |
synoppy_screenshot |
/api/screenshot |
URL → PNG (base64 data URL) for vision models |
Each tool returns a compact JSON string plus creditsUsed, and hands back {"error", "code"} on failure so the agent can recover.
For typed extraction (a JSON Schema), custom timeouts, or raw responses, use the synoppy client directly.
MIT licensed · built by Saanora
Metadata
Release files for crewai-synoppy 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| crewai_synoppy-1.0.0.tar.gz | 5.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| crewai_synoppy-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 10.8 kB
Release files / crewai_synoppy-1.0.0.tar.gz
| Download URL | crewai_synoppy-1.0.0.tar.gz |
|---|---|
| Size | 5.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b38e387b9370486215cffd13e31b762ba9114bd89290970859f8949e33bb5a31
|
|
BLAKE2b-256 checksum How to use checksums |
7ead06b6ed68b9d7bb3664927a85bae06717ee595534840ab929777037712c03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.8
|
Release files / crewai_synoppy-1.0.0-py3-none-any.whl
| Download URL | crewai_synoppy-1.0.0-py3-none-any.whl |
|---|---|
| Size | 5.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0f0f04b0b91b583985da54add54488502a0fdd6f373f893ee1d2b211e5bb1139
|
|
BLAKE2b-256 checksum How to use checksums |
60448bc88b58943bdd481e4b246e3d3d923be1342502934c0feb4b42b3d639e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.8
|