Here is the one full block including frontmatter (title and tags) so you can copy everything in a single click and paste it directly into the De
Whenever developers build autonomous agent workflows or RAG pipelines that need live web access, they hit three major bottlenecks:
- Context Bloat: Dumping raw HTML consumes 90% of the context window on scripts, tracking tags, and style attributes.
- Brittle Selectors: Using CSS or XPath selectors breaks the moment a target website pushes a frontend update.
- Agent Link Traps: Letting autonomous agents navigate arbitrary URLs exposes them to phishing sites, fake dApps, and malicious traps.
To solve this, we open-sourced official community toolkits for both LangChain and LlamaIndex:
pip install langchain-opticparse
pip install llama-index-tools-opticparse
1. Quickstart: 2-Line LangChain Agent Integration
from langchain_opticparse import OpticParseTool, PhishVisionTool
# 1. Zero-CSS visual scraper that returns clean, token-efficient Markdown
optic = OpticParseTool()
content = optic.run({
"url": "https://news.ycombinator.com",
"query": "Extract the top 5 articles with titles and links"
})
print(content)
# 2. Real-time zero-day threat check before interacting with unknown URLs
phish = PhishVisionTool()
safety = phish.run({"url": "https://suspicious-dapp-claim.xyz"})
print(safety)
2. LlamaIndex ToolSpec Usage
from llama_index.tools.opticparse import OpticParseToolSpec
from llama_index.core.agent import FunctionCallingAgentWorker
tool_spec = OpticParseToolSpec()
# Extract structured documents directly for LlamaIndex indexation
docs = tool_spec.extract(url="https://example.com", query="Extract specs")
print(docs[0].text)
# Convert directly to agent tool list
tools = tool_spec.to_tool_list()
3. What's Under the Hood?
- Resilient Web Extraction: Converts messy JavaScript pages into structured Markdown with 96% noise reduction without managing brittle selectors.
- PhishVision Shield: Heuristic scanner detecting brand impersonations, zero-day phishing kits, and crypto wallet drainers.
-
Autonomous Swarm Architecture: We included a full 3-agent market research swarm (Scout Agent, Sentinel Agent, Analyst Agent) in our open-source repo (
examples/autonomous_market_researcher.py). - Cross-Framework: Works across LangChain, LlamaIndex, Claude Desktop/Cursor (MCP), and ElizaOS.
Links & Open Source
⭐ GitHub: https://github.com/parastejpal987-cmyk/opticparse-public
📦 PyPI: https://pypi.org/project/langchain-opticparse/
📊 Live Benchmark: https://huggingface.co/spaces/paras9909/opticparse-vision-benchmark
Would love to hear your thoughts and feedback on how you're handling web retrieval in your agent pipelines!
---
Top comments (0)