opticparse-agentkit-action 1.0.0

package/README.md

@@ -0,0 +1,46 @@
+# opticparse-agentkit-action
+
+Official **Coinbase AgentKit** action provider for **OpticParse** multimodal web scraping and **PhishVision** zero-day threat intelligence on **Base**.
+
+Enables autonomous crypto agents equipped with Base wallets to:
+1. **Visually Scrape The Web:** Extract clean structured JSON schemas without breaking on dynamic CSS or anti-bot protections.:2. **Inspect Zero-Day Threats:** Scan unknown dApps and contracts for crypto-drainers before interacting.
+3. **HTTP 402 Machine Settlement:** Autonomously settle micropayments ($0.05 USDC) on Base.
+
+---
+
+## Installation
+
+gbash
+npm install opticparse-agentkit-action
+```
+
+---
+
+## Usage with Coinbase AgentKit
+
+```typescript
+import { OpticParseActionProvider } from "opticparse-agentkit-action";
+
+// 1. Initialize Action Provider
+const opticParseProvider = new OpticParseActionProvider({
+  apiKey: process.env.OPTICPARSE_API_KEY // or settles autonomously via Base USDC
+});
+
+// 2. Perform Visual Web Extraction
+const result = await opticParseProvider.scrapeWebpage({
+  url: "https://news.ycombinator.com",
+  query: "Extract top stories with points and author"
+});
+console.log("Scraped Data:", result);
+
+// 3. Scan Suspicious URL for Crypto Drainers
+const securityReport = await opticParseProvider.scanThreat({
+  url: "https://suspicious-airdrop-claim.xyz"
+});
+const.log("Security Verdict:", securityReport);
+```
+
+---
+
+## License
+MIT © OpticParse Enterprise

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Coinbase AgentKit Action Provider for OpticParse
+ * Enables autonomous on-chain agents on Base to perform visual web scraping
+ * and zero-day threat detection via HTTP 402 / USDC settlement.
+ */
+export interface OpticParseScrapeParams {
+    url: string;
+    query?: string;
+    paymentTxHash?: string;
+}
+export interface PhishVisionScanParams {
+    url: string;
+}
+export declare class OpticParseActionProvider {
+    private endpoint;
+    private apiKey;
+    private treasuryEvm;
+    constructor(options?: {
+        endpoint?: string;
+        apiKey?: string;
+        treasuryEvm?: string;
+    });
+    /**
+     * Scrapes structured JSON from any URL without breaking on CSS changes or anti-bot checks.
+     */
+    scrapeWebpage(args: OpticParseScrapeParams): Promise<any>;
+    /**
+     * Inspects a URL for malicious crypto drainers, zero-day phishing kits, or brand impersonations.
+     */
+    scanThreat(args: PhishVisionScanParams): Promise<any>;
+}
+export default OpticParseActionProvider;

package/dist/index.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Coinbase AgentKit Action Provider for OpticParse
+ * Enables autonomous on-chain agents on Base to perform visual web scraping
+ * and zero-day threat detection via HTTP 402 / USDC settlement.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpticParseActionProvider = void 0;
+class OpticParseActionProvider {
+    endpoint;
+    apiKey;
+    treasuryEvm;
+    constructor(options) {
+        const env = typeof process !== 'undefined' && process.env ? process.env : {};
+        this.endpoint = options?.endpoint || env.OPTICPARSE_ENDPOINT || 'https://opticparse-mcp-portal.parastejpal987.workers.dev';
+        this.apiKey = options?.apiKey || env.OPTICPARSE_API_KEY || 'op_live_agentkit';
+        this.treasuryEvm = options?.treasuryEvm || '0xd458E709e7d54fd3659EF66624A621Cde74EDD27';
+    }
+    /**
+     * Scrapes structured JSON from any URL without breaking on CSS changes or anti-bot checks.
+     */
+    async scrapeWebpage(args) {
+        const targetUrl = args.url;
+        const query = args.query || 'Extract structured data, pricing, and main content';
+        const headers = {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.apiKey}`,
+            'User-Agent': 'Coinbase-AgentKit-OpticParse/1.0'
+        };
+        if (args.paymentTxHash) {
+            headers['X-Payment-TxHash'] = args.paymentTxHash;
+        }
+        const targetEndpoint = this.endpoint + '/mcp/tools/opticparse_extract';
+        const response = await fetch(targetEndpoint, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ url: targetUrl, query })
+        });
+        if (response.status === 402) {
+            return {
+                status: 'payment_required',
+                code: 402,
+                required_amount_usdc: 0.05,
+                recipient_treasury: this.treasuryEvm,
+                accepted_chain: 'base',
+                instructions: 'Transfer 0.05 USDC on Base to recipient_treasury and pass paymentTxHash in parameters.'
+            };
+        }
+        return await response.json();
+    }
+    /**
+     * Inspects a URL for malicious crypto drainers, zero-day phishing kits, or brand impersonations.
+     */
+    async scanThreat(args) {
+        const scanEndpoint = this.endpoint + '/phishvision/scan';
+        const response = await fetch(scanEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`
+            },
+            body: JSON.stringify({ url: args.url })
+        });
+        return await response.json();
+    }
+}
+exports.OpticParseActionProvider = OpticParseActionProvider;
+exports.default = OpticParseActionProvider;

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "opticparse-agentkit-action",
+  "version": "1.0.0",
+  "description": "Coinbase AgentKit Action Provider for OpticParse Vision Web Scraping on Base",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "agentkit",
+    "coinbase",
+    "base",
+    "opticparse",
+    "web-scraping",
+    "x402"
+  ],
+  "author": "OpticParse Enterprise",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,87 @@
+/**
+ * Coinbase AgentKit Action Provider for OpticParse
+ * Enables autonomous on-chain agents on Base to perform visual web scraping
+ * and zero-day threat detection via HTTP 402 / USDC settlement.
+ */
+
+declare var process: any;
+
+export interface OpticParseScrapeParams {
+  url: string;
+  query?: string;
+  paymentTxHash?: string;
+}
+
+export interface PhishVisionScanParams {
+  url: string;
+}
+
+export class OpticParseActionProvider {
+  private endpoint: string;
+  private apiKey: string;
+  private treasuryEvm: string;
+
+  constructor(options?: { endpoint?: string; apiKey?: string; treasuryEvm?: string }) {
+    const env = typeof process !== 'undefined' && process.env ? process.env : {};
+    this.endpoint = options?.endpoint || env.OPTICPARSE_ENDPOINT || 'https://opticparse-mcp-portal.parastejpal987.workers.dev';
+    this.apiKey = options?.apiKey || env.OPTICPARSE_API_KEY || 'op_live_agentkit';
+    this.treasuryEvm = options?.treasuryEvm || '0xd458E709e7d54fd3659EF66624A621Cde74EDD27';
+  }
+
+  /**
+   * Scrapes structured JSON from any URL without breaking on CSS changes or anti-bot checks.
+   */
+  async scrapeWebpage(args: OpticParseScrapeParams): Promise<any> {
+    const targetUrl = args.url;
+    const query = args.query || 'Extract structured data, pricing, and main content';
+    
+    const headers: Record<string, string> = {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${this.apiKey}`,
+      'User-Agent': 'Coinbase-AgentKit-OpticParse/1.0'
+    };
+
+    if (args.paymentTxHash) {
+      headers['X-Payment-TxHash'] = args.paymentTxHash;
+    }
+
+    const targetEndpoint = this.endpoint + '/mcp/tools/opticparse_extract';
+    const response = await fetch(targetEndpoint, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify({ url: targetUrl, query })
+    });
+
+    if (response.status === 402) {
+      return {
+        status: 'payment_required',
+        code: 402,
+        required_amount_usdc: 0.05,
+        recipient_treasury: this.treasuryEvm,
+        accepted_chain: 'base',
+        instructions: 'Transfer 0.05 USDC on Base to recipient_treasury and pass paymentTxHash in parameters.'
+      };
+    }
+
+    return await response.json();
+  }
+
+  /**
+   * Inspects a URL for malicious crypto drainers, zero-day phishing kits, or brand impersonations.
+   */
+  async scanThreat(args: PhishVisionScanParams): Promise<any> {
+    const scanEndpoint = this.endpoint + '/phishvision/scan';
+    const response = await fetch(scanEndpoint, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify({ url: args.url })
+    });
+
+    return await response.json();
+  }
+}
+
+export default OpticParseActionProvider;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}