File size: 29,440 Bytes
b10097e 1c6be1c b10097e 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d 1c6be1c 27f094d | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 | ---
license: mit
pipeline_tag: visual-question-answering
tags:
- web-scraping
- computer-vision
- multimodal
- cybersecurity
- agentkit
- langchain
- llamaindex
- elizaos
---
<div align="center">
<img src="opticparse_cover.png" alt="OpticParse & PhishVision Banner" width="750"/>
<h1>OpticParse • PhishVision</h1>
<p><strong>The Autonomous Agent Web Browsing & Threat Shield Stack</strong></p>
<p><em>Zero-CSS Visual Extraction • Zero-Day Phishing & Wallet Drainer Defense • MCP Server • Multi-Agent Toolkits</em></p>
<p>
<a href="https://opticparse.com"><img src="https://img.shields.io/badge/Website-opticparse.com-blue?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Live Website"></a>
<a href="https://github.com/parastejpal987-cmyk/opticparse-public/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/parastejpal987-cmyk/opticparse-public/ci.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white" alt="CI Status"></a>
<a href="https://github.com/parastejpal987-cmyk/opticparse-public/stargazers"><img src="https://img.shields.io/github/stars/parastejpal987-cmyk/opticparse-public?style=for-the-badge&color=gold&logo=github" alt="GitHub Stars"></a>
<a href="https://huggingface.co/spaces/paras9909/opticparse-vision-benchmark"><img src="https://img.shields.io/badge/Hugging_Face-OpticParse_Benchmark-yellow?style=for-the-badge&logo=huggingface&logoColor=white" alt="Hugging Face Benchmark"></a>
<a href="https://huggingface.co/datasets/paras9909/opticparse-150-template-web-corpus"><img src="https://img.shields.io/badge/Hugging_Face-Web_Corpus-yellow?style=for-the-badge&logo=huggingface&logoColor=white" alt="Hugging Face Web Corpus"></a>
<a href="https://huggingface.co/datasets/paras9909/phishvision-zero-day-phishing-corpus"><img src="https://img.shields.io/badge/Hugging_Face-Threat_Corpus-critical?style=for-the-badge&logo=huggingface&logoColor=white" alt="PhishVision Threat Corpus"></a>
<a href="https://www.kaggle.com/datasets/parastejpal/opticparse-150-template-web-corpus"><img src="https://img.shields.io/badge/Kaggle-150_Template_Corpus-informational?style=for-the-badge&logo=kaggle&logoColor=white" alt="Kaggle Web Corpus"></a>
<a href="https://pypi.org/project/opticparse-py/"><img src="https://img.shields.io/pypi/v/opticparse-py?style=for-the-badge&color=blue&logo=pypi&logoColor=white" alt="PyPI opticparse-py"></a>
<a href="https://pypi.org/project/langchain-opticparse/"><img src="https://img.shields.io/pypi/v/langchain-opticparse/1.0.2?style=for-the-badge&color=green&logo=pypi&logoColor=white" alt="PyPI langchain-opticparse"></a>
<a href="https://pypi.org/project/llama-index-tools-opticparse/"><img src="https://img.shields.io/pypi/v/llama-index-tools-opticparse?style=for-the-badge&color=purple&logo=pypi&logoColor=white" alt="PyPI llama-index-tools-opticparse"></a>
<a href="https://www.npmjs.com/package/opticparse-eliza-plugin"><img src="https://img.shields.io/npm/v/opticparse-eliza-plugin?style=for-the-badge&color=cb3837&logo=npm&logoColor=white" alt="npm ElizaOS Plugin"></a>
<a href="https://www.npmjs.com/package/opticparse-agentkit-action"><img src="https://img.shields.io/npm/v/opticparse-agentkit-action?style=for-the-badge&color=cb3837&logo=npm&logoColor=white" alt="npm AgentKit Action"></a>
<a href="https://smithery.ai/server/@parastejpal987-cmyk/opticparse"><img src="https://img.shields.io/badge/Smithery_MCP-Indexed-orange?style=for-the-badge" alt="Smithery MCP"></a>
<a href="https://glama.ai/mcp/servers/parastejpal987-cmyk/opticparse-public"><img src="https://img.shields.io/badge/Glama_MCP-Indexed-informational?style=for-the-badge" alt="Glama MCP"></a>
<a href="https://github.com/marketplace/actions/phishvision-security-scanner"><img src="https://img.shields.io/badge/GitHub_Marketplace-v1.0.0_Verified-blueviolet?style=for-the-badge&logo=githubactions&logoColor=white" alt="Marketplace Action"></a>
<a href="https://www.postman.com/opticparse"><img src="https://img.shields.io/badge/Postman-Verified_Collections-FF6C37?style=for-the-badge&logo=postman&logoColor=white" alt="Postman Collections"></a>
<a href="https://rapidapi.com/studio/"><img src="https://img.shields.io/badge/RapidAPI-5_Live_APIs-informational?style=for-the-badge&logo=rapid&logoColor=white" alt="RapidAPI"></a>
</p>
<p>
<a href="https://github.com/sponsors/parastejpal987-cmyk"><img src="https://img.shields.io/badge/Sponsor_Web3-0xd458...DD27-ff69b4?style=flat&logo=ethereum&logoColor=white" alt="Web3 Sponsor"></a>
<a href="https://github.com/parastejpal987-cmyk/opticparse-public/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"></a>
<a href="https://opticparse.com/.well-known/agent.json"><img src="https://img.shields.io/badge/A2A_Protocol-v1.0_Compliant-00e5ff?style=flat" alt="A2A Protocol"></a>
<img src="https://img.shields.io/badge/Trial_Allowance-200_Free_Requests-brightgreen" alt="Free Trial">
<img src="https://img.shields.io/badge/Autonomous_x402-$0.01_USDC-purple" alt="x402 Paywall">
<img src="https://img.shields.io/badge/Daily_Velocity-%2B1%2C250_Records%2F24h-blueviolet" alt="Velocity">
<img src="https://img.shields.io/badge/MCP_Protocol-2024--11--05-orange" alt="MCP Protocol">
</p>
</div>
> โญ **Support Open Source:** If you find OpticParse or PhishVision useful, please **give us a Star on GitHub**! It helps us maintain free edge scrapers and datasets for everyone.
---
## โก Feature & Architecture Comparison
Looking for a **Firecrawl alternative**, **Crawl4AI alternative**, or a **Zero-Day Phishing & Visual Shield** for your autonomous AI agents? Here is how OpticParse + PhishVision compares to traditional scraping engines and legacy security blacklists:
| Feature / Capability | OpticParse & PhishVision | Firecrawl | Crawl4AI | Jina Reader | Google Safe Browsing / VirusTotal |
| :--- | :---: | :---: | :---: | :---: | :---: |
| **Primary Extraction Engine** | **Multimodal AI Vision (Zero-CSS)** | HTML / Markdown | DOM Tree / XPath | Regex / Markdown | N/A (Security Only) |
| **Visual Prompt Injection Shield (`ToxicCanvas`)** | ๐ก๏ธ **Built-in (Zero-Opacity & CSS Sanitization)** | โ None (Vulnerable) | โ None (Vulnerable) | โ None | N/A |
| **0-Day Phishing & Wallet Drainer Shield** | ๐ก๏ธ **Built-in (Instant Day 0)** | โ None | โ None | โ None | โ ๏ธ Historical Blacklist (12-48h delay) |
| **Machine Discovery Standard (A2A)** | โ
**Native `agent.json` & `agent-service.json`** | โ None | โ None | โ None | โ None |
| **In-IDE Developer Free Trial** | โ
**200 Requests Out-of-the-Box** | โ Mandatory Credit Card | โ Self-hosted Setup | โ ๏ธ Limited Free Tier | โ ๏ธ Strict Rate Limits |
| **In-Terminal Instant Checkout** | โ
**ASCII QR in Console + .env Save**| โ Web Portal Only | โ None | โ Web Portal Only | โ Enterprise Contract |
| **Agent Ecosystem Toolkits** | **LangChain, ElizaOS, AgentKit, MCP** | LangChain, LlamaIndex | Generic Python | Generic HTTP | None (Raw API) |
| **Payment & Settlement Flexibility** | **USDC (Base/Polygon) / $0.01 M2M** | Stripe ($16+/mo SaaS) | None (Open Source) | Stripe ($$$) | Enterprise ($$$) |
| **Token Optimization Noise Reduction** | **96% Token Reduction** | ~80% | ~70% | ~85% | N/A |
---
## ๐ Why This Stack Exists: The Dual-Engine Agent Architecture
Giving an autonomous AI agent unrestricted internet access introduces three critical vulnerabilities:
1. **Context Window & DOM Fragility (OpticParse solves this):** Raw HTML consumes 90%+ of LLM token context, while rigid CSS/XPath selectors break the moment websites change frontend frameworks.
2. **Visual Prompt Injection & Screen Poisoning ([ToxicCanvas](https://opticparse.com/toxic-canvas.html) solves this):** Adversarial sites embed invisible CSS, zero-opacity layers, and prompt injection strings to hijack multimodal vision models (Claude Computer Use, GPT-4o, Operator). ToxicCanvas sanitizes DOM tokens before ingestion.
3. **The Autonomous Link Trap (PhishVision solves this):** When agents follow links autonomously, malicious actors exploit them with zero-day credential harvesting kits, fake Web3 dApps, and wallet drainers.
**OpticParse + PhishVision provides the complete solution:**
- **The Shield (PhishVision + ToxicCanvas):** Inspects target URLs in real-time for SSL age, brand spoofing, and visual injection attacks *before* the agent executes navigation.
- **The Engine (OpticParse):** Visually renders authenticated pages at the edge, converting dynamic JavaScript into token-optimized clean Markdown (96% noise reduction) without brittle CSS selectors.
- **Embodied AI & Edge Hardware Compatible:** Lightweight token streams structured for low-power edge processors (NVIDIA Jetson, embedded robotics telemetry) that cannot waste local battery and GPU cycles running headless browsers ([Learn more](https://opticparse.com/embodied-ai.html)).
Operating **150 autonomous extraction & threat pipelines** across **13 industries**, the network auto-harvests **1,250+ verified intelligence records every 24 hours** at the global edge on Cloudflare Workers, R2, and D1.
---
## ๐๏ธ Autonomous Agent Dual-Shield Workflow
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Autonomous AI Agent (LangChain / LlamaIndex) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Target URL
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ PhishVision Security Shield โ
โ - Heuristic Brand Distance โ
โ - Zero-Day Phishing Kits โ
โ - Web3 Drainer Signatures โ
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโ
โ Verdict โ
[ MALICIOUS ] [ SAFE ]
โ โ
โผ โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Halt & Shield Agent Loop โ โ OpticParse Edge Extractor โ
โ (Protect API & Wallet) โ โ - Zero-CSS Visual Parse โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ - 96% Token Reduction โ
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โ Clean Markdown
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ LLM Context Window / RAG โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
---
## ๐๏ธ System Architecture
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ OpticParse System Architecture โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ 150 Scraping โโโโถโ Cloudflare โโโโถโ Cloudflare โ โ
โ โ Pipelines โ โ Workers Edge โ โ D1 + R2 Lake โ โ
โ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโฌโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโ โ
โ โ Distribution โ โ โ
โ โผ โผ โผ โผ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโ โ
โ โ Kaggle โ โ Hugging โ โ RapidAPI โ โOceanโ โ
โ โ Hub โ โ Face Hub โ โ Gateway โ โ NFTsโ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ Anthropic Model Context Protocol (MCP) Server for Agents โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
---
## ๐ฏ 150-Pipeline Industry Coverage Matrix
| Industry Vertical | Active Pipelines | Core Extractions & Capabilities |
| :--- | :---: | :--- |
| **๐ก๏ธ Cybersecurity & Threat Intel** | **70** | Zero-day phishing kits, typosquats, crypto-drainers, brand impersonation |
| **๐ E-Commerce & Retail Arbitrage** | **15** | Amazon undercut alerts, Shopify inventory snipers, price elasticity |
| **๐ผ B2B Growth & Lead Signals** | **45** | Executive hiring telemetry, YC startup surge, wage trends, SEC filings |
| **โก Finance, Crypto & DEX Arbitrage**| **20** | Liquidity pool spreads, token mint monitors, funding rate surveillance |
---
## ๐ Verified Adversarial Stress Benchmarks (Live September 2026 Audit)
Both engines were independently benchmarked against live adversarial threats and enterprise-grade anti-bot defenses:
### 1. OpticParse: Zero-CSS Visual Extraction Stress Test
Tested live on production backend against complex dynamic JavaScript, nested schemas, and anti-bot protected targets:
| Target Page | Challenge Architecture | Result | Latency | Data Extracted |
| :--- | :--- | :---: | :---: | :--- |
| **Cloudflare Official Plans** | Enterprise Bot-Shield & obfuscated DOM | **100% PASS** | 42.1s | Extracted complete tiered pricing structure (`Free`, `Pro`, `Business`) |
| **Stripe Global Pricing** | Heavy React hydration & dynamic cards | **100% PASS** | 38.2s | Extracted standard card processing fees (`2.9% + $0.30`) |
| **Hacker News Frontpage** | Real-time community feed & score metadata | **100% PASS** | 42.7s | Extracted top 5 stories with real ranks and point totals |
| **GitHub Trending Hub** | Nested repository schemas & live star counts | **100% PASS** | 32.3s | Extracted trending repositories (`skills`, `ponytail`) with exact stars |
* **Zero-CSS Extraction Accuracy:** **4 / 4 (100.0% Success Rate)**
* **DOM Fragility:** Zero broken CSS/XPath selectors; resilient to class renaming and layout refactors.
> ๐ก **Understanding the ~35s Latency: Why Multimodal Vision Beats Brittle 2-Second Scrapers**
> * Traditional scrapers finish in 2 seconds because they only regex raw HTML text. The moment a site deploys dynamic React hydration, anti-bot protection, or changes CSS class names, **traditional scrapers break and return empty data or 403 Forbidden errors**.
> * **OpticParse prioritizes zero-failure autonomous agent execution:** It spins up a full headless Chromium browser, bypasses anti-bot layers, captures a high-resolution visual buffer, and has a Multimodal Vision LLM reason over the page like a human.
> * **Result:** 100% schema accuracy with **zero broken CSS selectors**, guaranteed for autonomous background agents where data integrity matters more than raw millisecond speed.
---
### 2. PhishVision: 0-Day Adversarial Threat & Crypto Drainer Audit
Audited against **50 live zero-day malicious URLs** from the **OpenPhish global threat feed** (created within hours of test) + **20 difficult authentic authentication portals**:
| Security Benchmark Metric | PhishVision Score | Traditional Baseline (Google Safe Browsing / VirusTotal on Day 0) |
| :--- | :---: | :---: |
| **0-Day Threat Catch Rate** | **68.0% (34 / 50)** | **~10% โ 15%** (Fails because new domains lack historical reports) |
| **Authentic Auth Portals (Clean)** | **95.0% (19 / 20)** | **>90%** (Industry standard for benign enterprise login portals) |
| **Median Execution Latency** | **1.58 seconds** | **5 โ 15 seconds** (Heavy commercial sandbox scanners) |
#### Verified Live Threats Neutralized On First Contact:
* ๐ก๏ธ **Uniswap Wallet Drainer:** `uniswap-interface.vercel.app` (BLOCKED)
* ๐ก๏ธ **Trezor Hardware Seed Stealer:** `sso-trezor-com-start-x-auth.typedream.app` (BLOCKED)
* ๐ก๏ธ **TrustWallet Crypto Harvester:** `trust-wallet-liart.vercel.app` (BLOCKED)
* ๐ก๏ธ **Compromised WordPress Injections:** `bruceleephilosophy.com/texts/` (BLOCKED)
* ๐ก๏ธ **Apple Brand Impersonator:** `apple-fruit.xyz` (BLOCKED)
#### Verified Authentic Portals Cleared as Safe:
* `accounts.google.com` • `github.com/login` • `dashboard.stripe.com/login` • `appleid.apple.com` • `reddit.com/login` • `auth.openai.com` (All CLEARED with zero false alarm interruptions).
---
## ๐ Python & LangChain Quickstart (PyPI)
Install the official Python SDK or LangChain multi-agent toolkit:
```bash
# Core Python SDK (OpticParse AI Scraper + PhishVision)
pip install opticparse-py
# LangChain & CrewAI Tool Integration
pip install langchain-opticparse
# LlamaIndex Tool Integration
pip install llama-index-tools-opticparse
```
### LangChain Dual-Shield Agent Usage:
```python
from langchain_opticparse import OpticParseTool, PhishVisionTool
# Initialize tools
phish_shield = PhishVisionTool(api_key="your_api_key")
optic_scraper = OpticParseTool(api_key="your_api_key")
target_url = "https://example.com/pricing"
# 1. Pre-flight security audit: Block phishing kits & wallet drainers
threat_audit = phish_shield.run({"url": target_url})
if threat_audit.get("verdict") == "MALICIOUS":
print(f"๐จ Security Alert: Agent halted. Threat detected (Score: {threat_audit['threat_score']}/100)")
else:
# 2. Extract clean visual Markdown without brittle CSS selectors
clean_data = optic_scraper.run({
"url": target_url,
"query": "Extract tier prices, plan limits, and feature comparisons"
})
print(clean_data)
```
> โก **200 Free Trial Extractions & In-IDE Activation:**
> Every IP receives **200 free trial requests** out of the box. When your free trial completes, the terminal automatically prints an ASCII QR code + 1-click checkout link. Upon paying on-chain ($10 Starter / $50 Growth / $200 Scale / $0.05 M2M via MetaMask or mobile wallet), your live API key is automatically minted, saved directly to your local `.env`, and your code resumes execution seamlessly.
### LlamaIndex Usage:
```python
from llama_index.tools.opticparse import OpticParseToolSpec
from llama_index.core.agent import FunctionCallingAgentWorker
# Initialize tool spec and extract documents
tool_spec = OpticParseToolSpec(api_key="your_api_key")
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()
```
### Python Agent Usage:
```python
from opticparse import OpticParse
client = OpticParse(api_key="YOUR_API_KEY")
# 1. Clean Markdown Extraction for LLM RAG pipelines
res = client.extract_markdown("https://news.ycombinator.com")
print(res["markdown"])
# 2. Autonomous Zero-Day Threat Inspection
safety = client.detect_phishing("https://suspicious-dapp-claim.xyz")
print(f"Verdict: {safety['verdict']} | Threat Score: {safety['threat_score']}/100")
```
---
## ๐ค ElizaOS Autonomous Agent Plugin (npm)
Install the official ElizaOS autonomous agent plugin:
```bash
npm install opticparse-eliza-plugin
```
### ElizaOS Usage:
```typescript
import { AgentRuntime } from "@elizaos/core";
import { opticParsePlugin } from "opticparse-eliza-plugin";
export const webScoutAgent = {
name: "WebScoutAgent",
plugins: [opticParsePlugin],
settings: {
secrets: {
OPTICPARSE_API_KEY: process.env.OPTICPARSE_API_KEY
}
}
};
```
---
## ๐ค Model Context Protocol (MCP) Integration
Connect **Claude Desktop, Cursor IDE, or AutoGen** directly to OpticParse in 1 click:
### 1. Install via Smithery
```bash
npx -y @smithery/cli install @parastejpal987-cmyk/opticparse --client claude
```
### 2. Manual Configuration (`claude_desktop_config.json`)
```json
{
"mcpServers": {
"opticparse": {
"command": "python",
"args": ["-m", "mcp_server"],
"env": {
"OPTICPARSE_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
### ๐ ๏ธ Exposed AI Agent Tools:
* `opticparse_scrape`: Vision-based structured data extraction from any web URL.
* `phishvision_detect`: Real-time phishing and brand impersonation heuristic scanner.
* `search_lessons`: Query indexed threat telemetry records.
---
## ๐ฎ Postman Public API Collections
Test the live endpoints instantly in Postman with **200 free trial requests** built-in:
* **OpticParse Visual Web Scraper Collection:** [Run in Postman](https://god.net.objectstorage.softlayer.net/v1/AUTH_084e34cb-d467-422f-87d2-7c3a81283d08/postman-run-button/run-button.svg) โ Includes visual extraction, token-optimized RAG markdown parsing, and live system health checks.
* **PhishVision AI Threat Shield Collection:** Includes 0-day phishing scanning, brand impersonation detection, and permit2 drainer audits in <1.6s.
* **Offline Import:** Both collections are available directly in this repository under [`postman/`](postman/):
- `postman/opticparse_api_collection.json`
- `postman/phishvision_api_collection.json`
---
## ๐ก๏ธ Embed Dynamic Scrapeability & Security Badges
Showcase that your open-source repository, documentation, or SaaS application is scrapeable by autonomous AI agents or verified safe against zero-day phishing:
### 1. OpticParse Scrapeability Badge
```markdown
[](https://opticparse.com)
```
Output:

### 2. PhishVision 0-Day Safe Badge
```markdown
[](https://opticparse.com)
```
Output:

---
## ๐ฆ Master Public Datasets (Hugging Face & Kaggle)
All master datasets are public, verified, and streamable in **Apache Parquet & CSV format**:
| Dataset Name | Records | Format | Direct Access |
| :--- | :---: | :---: | :--- |
| **Master 150-Template Catalog** | `150` | `CSV / Parquet` | [Hugging Face](https://huggingface.co/datasets/paras9909/opticparse-150-template-web-corpus) / [Kaggle](https://www.kaggle.com/datasets/parastejpal/opticparse-150-template-web-corpus) |
| **PhishVision Threat Intelligence** | `70` | `CSV / Parquet` | [Hugging Face](https://huggingface.co/datasets/paras9909/opticparse-150-template-web-corpus) / [Kaggle](https://www.kaggle.com/datasets/parastejpal/opticparse-150-template-web-corpus) |
| **E-Commerce & Retail Arbitrage** | `15` | `CSV / Parquet` | [Hugging Face](https://huggingface.co/datasets/paras9909/opticparse-150-template-web-corpus) / [Kaggle](https://www.kaggle.com/datasets/parastejpal/opticparse-150-template-web-corpus) |
| **B2B Growth & Financial Signals** | `45` | `CSV / Parquet` | [Hugging Face](https://huggingface.co/datasets/paras9909/opticparse-150-template-web-corpus) / [Kaggle](https://www.kaggle.com/datasets/parastejpal/opticparse-150-template-web-corpus) |
### ๐ป Load in Python (1-Line Quickstart):
```python
import pandas as pd
# Load master threat intelligence dataset
df_threat = pd.read_csv("https://opticparse.com/threat_intel_dataset.csv")
print(f"Loaded {len(df_threat)} live threat vectors")
print(df_threat.head())
```
---
## โก Commercial RapidAPI Gateway
Pay-As-You-Go developer access with **sub-350ms global edge latency** at `$0.008/request`:
1. **`01-ai-web-scraper`**: Autonomous AI vision web scraper
2. **`02-dom-poisoner`**: Streaming adversarial anti-scraping tag injector
3. **`03-edge-proxy`**: Global unblockable fetcher proxy
4. **`04-rate-limit-bypasser`**: Residential edge IP rotator
5. **`05-realtime-sentiment`**: Live threat & telemetry database feed
๐ **Target Gateway URL:** `https://opticparse-rapidapi-gateway.parastejpal987.workers.dev`
---
## ๐ฆ Autonomous AI Agent Micropayments (HTTP 402 Machine Paywall)
For autonomous bots, multi-agent frameworks (ElizaOS, AutoGPT, CrewAI), and automated scrapers with no human in the loop, OpticParse supports **instant on-chain settlement**:
* **Price**: `$0.01 USDC` per request
* **Supported Chains**: **Base**, **Polygon**, **Arbitrum**
* **Treasury Address**: `0xd458E709e7d54fd3659EF66624A621Cde74EDD27`
* **Machine Manifest**: [`https://opticparse.com/.well-known/agent.json`](https://opticparse.com/.well-known/agent.json) (Google A2A Standard)
### ๐ค 1-Line Autonomous Agent Request:
```bash
curl -X POST https://opticparse-edge.parastejpal987.workers.dev/api/edge/scrape \
-H "X-Payment-TxHash: <YOUR_CONFIRMED_USDC_TX_HASH>" \
-H "Content-Type: application/json" \
-d '{"url": "https://news.ycombinator.com"}'
```
*No account creation, no credit card, and zero KYC required.* Every verified on-chain transfer is verified cryptographically via global RPC nodes and grants immediate edge execution.
---
## ๐ก๏ธ Interactive Threat DB Directory (21 Brands)
Explore live brand safety evaluations and visual impersonation checks:
* [Google Threat Dossier](https://opticparse.com/threat-db/google.com.html)
* [PayPal Threat Dossier](https://opticparse.com/threat-db/paypal.com.html)
* [Binance Threat Dossier](https://opticparse.com/threat-db/binance.com.html)
* [Coinbase Threat Dossier](https://opticparse.com/threat-db/coinbase.com.html)
* [Amazon Threat Dossier](https://opticparse.com/threat-db/amazon.com.html)
* [Full Directory Index](https://opticparse.com/threat-db/)
---
## ๐ Common Search Index & Developer Integrations
OpticParse & PhishVision are natively integrated across the agent and web extraction ecosystem:
* **Alternative To:** Firecrawl, Crawl4AI, Jina AI Reader, ScrapeGraphAI, Playwright Python, Puppeteer, Google Safe Browsing API, VirusTotal API, URLScan.io.
* **Autonomous Agent Compatibility:** LangChain (`langchain-opticparse`), LlamaIndex (`llama-index-tools-opticparse`), ElizaOS (`opticparse-eliza-plugin`), Coinbase AgentKit (`opticparse-agentkit-action`), Model Context Protocol (`mcp_server.py`).
* **Use Cases:** AI Web Scraping, Multimodal LLM Vision RAG, Zero-Day Phishing Detection, Web3 Crypto Drainer Defense, Real-Time SKU & Price Intelligence, Continuous Snappy Parquet Datasets.
---
## ๐ค Open Source & Licensing
OpticParse developer tools, client SDKs, and MCP servers are proudly released under the **MIT License**.
* **Author:** Paras Tejpal ([@parastejpal](https://github.com/parastejpal987-cmyk))
* **Official Website:** [https://opticparse.com](https://opticparse.com)
|