opticparse-eliza-plugin

Official ElizaOS v2 plugin for OpticParse and PhishVision.

Enables autonomous AI agent swarms to:

1. Vision Scrape (OPTICPARSE_VISION_SCRAPE): Extract structured JSON data from any live webpage using Multimodal Vision AI without fragile CSS selectors.
2. PhishVision Threat Scan (PHISHVISION_PREFLIGHT_GUARD): Analyze zero-day phishing kits, brand clones, and crypto wallet drainers before visiting or signing transactions.

📦 Installation

npm install opticparse-eliza-plugin
# or
pnpm add opticparse-eliza-plugin

🚀 Usage in ElizaOS Agent

import { opticParsePlugin, opticParseScrapeAction, phishVisionGuardAction } from "opticparse-eliza-plugin";

// Register directly into your Eliza character runtime:
export default {
  name: "MyAutonomousAgent",
  plugins: [opticParsePlugin],
  // ...
};

⚙️ Configuration

Add to your Eliza character configuration file (character.json):

{
  "plugins": ["opticparse-eliza-plugin"],
  "settings": {
    "secrets": {
      "OPTICPARSE_MCP_URL": "https://opticparse-mcp-portal.parastejpal987.workers.dev",
      "OPTICPARSE_API_KEY": "your_opticparse_api_key"
    }
  }
}

🛡️ Available Actions & Exports

1. OPTICPARSE_VISION_SCRAPE (Alias: VISION_SCRAPE)

Extracts clean, structured JSON from dynamic, anti-bot protected webpages without brittle CSS selectors.

"Agent, scrape the latest AI model pricing from https://example.com/pricing"

2. PHISHVISION_PREFLIGHT_GUARD (Alias: PHISHVISION_DETECT)

Inspects target links in real-time for zero-day crypto drainers, homoglyphs, and brand clones before an agent clicks or signs transactions.

"Agent, inspect this link before signing any transaction: https://suspicious-airdrop.xyz"

🔒 Error Handling & Resilient Contracts

All actions implement graceful failover contracts:

• SUCCESS: Returns verified structured data or threat verdict.
• PROVIDER_UNAVAILABLE: Gracefully reports provider unavailability or timeout (10s) without throwing uncaught runtime errors.
• INVALID_TARGET: Validates URL structure before dispatch.

📄 License

MIT © OpticParse Enterprise