@minia2a/elizaos-plugin-minia2a 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +44 -32
  2. package/package.json +12 -3
package/README.md CHANGED
@@ -1,18 +1,19 @@
1
1
  # @minia2a/elizaos-plugin-minia2a
2
2
 
3
- **ElizaOS plugin for [minia2a.uk](https://minia2a.uk)** — discover and call 299+ x402 pay-per-call APIs directly from your AI agent.
3
+ **The marketplace plugin for ElizaOS agents** — discover, try, and pay for 299+ x402 APIs across crypto, web, AI, and data. USDC on Base.
4
4
 
5
- ## What This Plugin Does
5
+ > Unlike single-vendor x402 plugins that bundle a fixed set of endpoints, this plugin connects your agent to the **entire minia2a.uk marketplace** — 299+ services from dozens of providers, with live discovery, free trials, and transparent pricing.
6
6
 
7
- Your ElizaOS agent gets 3 new abilities:
7
+ ## Why This Plugin
8
8
 
9
- | Action | What it does |
10
- |--------|-------------|
11
- | `SEARCH_APIS` | Search 299+ APIs by keyword or category |
12
- | `CALL_API` | Call any endpoint with auto-trial (15 free calls per API) |
13
- | `LIST_POPULAR_APIS` | Browse trending/most-used services |
14
-
15
- Plus a provider that injects live marketplace stats into the agent's context.
9
+ | Feature | Fixed-Endpoint Plugins | This Plugin |
10
+ |---------|----------------------|-------------|
11
+ | Services | 8–75 endpoints | **299+ across categories** |
12
+ | Discovery | Pre-bundled at build time | **Live marketplace search** |
13
+ | Free trials | Sometimes | **15 free calls per endpoint** |
14
+ | New services | Wait for plugin update | **Available instantly** |
15
+ | Provider diversity | Single vendor | **Dozens of providers** |
16
+ | Payment | USDC on chain | **USDC on Base (~3¢ gas)** |
16
17
 
17
18
  ## Install
18
19
 
@@ -20,7 +21,7 @@ Plus a provider that injects live marketplace stats into the agent's context.
20
21
  npm install @minia2a/elizaos-plugin-minia2a
21
22
  ```
22
23
 
23
- ## Configure
24
+ ## Quick Start
24
25
 
25
26
  Add to your agent's `character.json`:
26
27
 
@@ -37,38 +38,49 @@ Add to your agent's `character.json`:
37
38
  }
38
39
  ```
39
40
 
40
- ## Usage
41
-
42
- Once configured, your agent can:
41
+ ## Actions
43
42
 
44
- **Search for APIs:**
45
- > "Search for APIs that can scrape websites"
43
+ | Action | What it does | Example prompt |
44
+ |--------|-------------|----------------|
45
+ | `SEARCH_APIS` | Search 299+ APIs by keyword or category | "Find APIs that can scrape websites" |
46
+ | `CALL_API` | Call any endpoint with auto-trial | "Get the current gas price on Base" |
47
+ | `LIST_POPULAR_APIS` | Browse trending services | "What are the most used APIs?" |
46
48
 
47
- **Browse the marketplace:**
48
- > "What APIs are available?"
49
+ ## Provider
49
50
 
50
- **Call an endpoint:**
51
- > "Call the /x402/gas endpoint" or "Try the gas price API"
51
+ The `MINIA2A_MARKETPLACE` provider injects live marketplace context into every agent interaction — service counts, popular endpoints, trial availability, and pricing.
52
52
 
53
53
  ## x402 Payment Flow
54
54
 
55
- This plugin handles the full x402 flow:
56
-
57
- 1. Agent requests an endpoint → gets **HTTP 402 Payment Required** with price + wallet address
55
+ 1. Agent requests endpoint → gets `HTTP 402 Payment Required` with price + wallet
58
56
  2. Agent auto-signs USDC on Base (if `paymentPrivateKey` configured)
59
- 3. Agent retries with payment proof → receives result
57
+ 3. Agent retries with `Authorization: x402 <signed-tx>` → receives result
58
+ 4. Receipt returned in `X-Receipt` header for audit trail
59
+
60
+ **Without a payment key:** the agent uses free trials — 15 calls per endpoint, zero setup, no wallet.
61
+
62
+ ## Categories
63
+
64
+ - 🤖 **AI/LLM** — text generation, classification, translation, summarization
65
+ - 🔗 **Web** — scraping, search, email verification, DNS, HTTP analysis
66
+ - 💰 **Crypto** — gas prices, wallet intel, token security, DEX data, Polymarket
67
+ - 🔐 **Security** — CAPTCHA solving, domain intel, SSL checks, OSINT
68
+ - 📊 **Data** — enrichment, validation, formatting, CSV/JSON conversion
69
+ - 🛠️ **Dev Tools** — code review, regex, UUID, hashing, JWT decode
60
70
 
61
- Without a payment key configured, the agent uses **free trials** (15 calls per endpoint).
71
+ ## Pricing
62
72
 
63
- ## Real Data
73
+ - **Free trial:** 15 calls per endpoint (`?trial=1`)
74
+ - **Paid calls:** Priced per endpoint (typically $0.001–$0.10)
75
+ - **Platform fee:** 5% (transparent, no hidden costs)
76
+ - **Credits:** 1 USDC = 200 credits, no subscription, no minimum
77
+ - **Settlement:** USDC on Base (~3¢ gas, ~2s confirmation)
64
78
 
65
- minia2a.uk currently has **299 services** with **8,144+ trials** from **318 developers** across categories including:
79
+ ## Related
66
80
 
67
- - 🤖 AI/LLM (text generation, classification, translation)
68
- - 🔗 Web (scraping, search, email verification)
69
- - 💰 Crypto (gas, prices, wallet intel, token security)
70
- - 🔐 Security (CAPTCHA solving, domain intel, audits)
71
- - 📊 Data (enrichment, validation, formatting)
81
+ - [minia2a.uk](https://minia2a.uk) — The marketplace
82
+ - [@minia2a/sdk](https://www.npmjs.com/package/@minia2a/sdk) — CLI for x402 developers
83
+ - [x402.org](https://x402.org) — The payment protocol
72
84
 
73
85
  ## License
74
86
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@minia2a/elizaos-plugin-minia2a",
3
- "version": "0.1.0",
4
- "description": "ElizaOS plugin for minia2a.uk — discover and call 299+ x402 pay-per-call APIs from your agent",
3
+ "version": "0.1.2",
4
+ "description": "ElizaOS plugin for the minia2a.uk marketplace — 299+ x402 pay-per-call APIs across crypto, web, AI, and data. 15 free trials per endpoint. USDC on Base.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
7
7
  "files": ["dist"],
@@ -16,10 +16,19 @@
16
16
  "x402",
17
17
  "minia2a",
18
18
  "agent-payments",
19
+ "pay-per-call",
19
20
  "usdc",
21
+ "base",
20
22
  "m2m",
21
23
  "ai-agent",
22
- "marketplace"
24
+ "marketplace",
25
+ "micropayments",
26
+ "web-scraping",
27
+ "crypto-data",
28
+ "captcha-solving",
29
+ "ai-inference",
30
+ "api-discovery",
31
+ "agent-economy"
23
32
  ],
24
33
  "author": "minia2a.uk",
25
34
  "license": "MIT",