@rileycraig/plugin-x402-agentstore 1.0.0

package/README.md

@@ -0,0 +1,45 @@
+# @rileycraig/plugin-x402-agentstore
+
+**Put paid AI data tools inside any ElizaOS agent.** This plugin gives ElizaOS agents native actions that call the [x402 Agent Store](https://store.agentexchange.work) and pay per request in USDC via [x402](https://www.x402.org) — no API keys, no subscriptions.
+
+This is how high-volume x402 services actually get called: not by being listed in a registry, but by being a **pre-installed tool inside the agents people run.** (BlockRun gets its volume by being ClawRouter inside OpenClaw; this puts our tools inside ElizaOS the same way.)
+
+## Actions
+
+| Action | What it does | Price |
+|---|---|---|
+| `AI_VISIBILITY_CHECK` | Does AI recommend a brand/token? Score 0–100 + who AI names instead | free teaser / $0.95 full |
+| `DEX_TOKEN_DATA` | Live DEX price, volume, liquidity, buy/sell flow for any token | $0.002 |
+| `AI_CATEGORY_RANKING` | Who AI recommends across a whole category, ranked | $0.02 |
+| `COUNTRY_ECONOMICS` | GDP, inflation, unemployment for 200+ countries | $0.005 |
+
+Paid calls settle from the agent's own x402 wallet on Base. Free teasers work with no payment.
+
+## Install
+
+```bash
+npm install @rileycraig/plugin-x402-agentstore
+```
+
+```ts
+import { x402AgentStorePlugin } from "@rileycraig/plugin-x402-agentstore";
+
+// add to your ElizaOS character / runtime plugins:
+plugins: [x402AgentStorePlugin]
+```
+
+## Build & publish
+
+```bash
+npm install
+npm run build
+npm publish --access public
+# then submit to the ElizaOS plugin registry so every ElizaOS agent can discover it
+```
+
+## Why
+The agent economy runs on agents calling tools inside their frameworks. This plugin makes the x402 Agent Store's unique data — especially **AI-visibility** (does AI recommend you?), which nothing else offers — a one-line install for the entire ElizaOS ecosystem.
+
+- Store: https://store.agentexchange.work · Free samples: https://store.agentexchange.work/samples
+- MCP (Claude/Cursor/Windsurf): https://store.agentexchange.work/mcp
+- License: MIT

package/dist/index.js

@@ -0,0 +1,86 @@
+// src/index.ts
+var STORE = "https://store.agentexchange.work";
+async function callStore(runtime, path) {
+  const f = runtime.fetch || fetch;
+  const res = await f(STORE + path, { headers: { accept: "application/json" } });
+  if (res.status === 402) {
+    let req = null;
+    try {
+      req = await res.json();
+    } catch {
+    }
+    return { payment_required: true, how: "Settle the x402 USDC payment on Base and retry with the X-PAYMENT header.", requirements: req };
+  }
+  return res.json();
+}
+var aiVisibility = {
+  name: "AI_VISIBILITY_CHECK",
+  similes: ["DOES_AI_RECOMMEND", "BRAND_VISIBILITY", "GEO_CHECK", "AI_REPUTATION"],
+  description: "Check whether AI assistants (ChatGPT/Perplexity/Gemini) recommend a brand or token in its category. Returns a 0-100 AI-visibility score, mention rate, and which competitors AI names instead. Free teaser via /score; full audit via paid /brands/check.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    var _a;
+    const text = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").trim();
+    const m = text.match(/(.+?)\s+(?:in|for)\s+(.+)/i);
+    const brand = ((m == null ? void 0 : m[1]) || text).replace(/^(check|is|does ai recommend)\s+/i, "").trim();
+    const category = ((m == null ? void 0 : m[2]) || "its category").trim();
+    const data = await callStore(runtime, `/score?brand=${encodeURIComponent(brand)}&category=${encodeURIComponent(category)}`);
+    if (callback) callback({ text: `AI-visibility for ${brand}: ${JSON.stringify(data)}`, content: data });
+    return true;
+  },
+  examples: []
+};
+var dexToken = {
+  name: "DEX_TOKEN_DATA",
+  similes: ["TOKEN_PRICE", "CRYPTO_DEX", "TOKEN_LIQUIDITY", "TOKEN_VOLUME"],
+  description: "Live decentralized-exchange data for any token (price, 24h volume, liquidity, buy/sell flow, momentum) across every chain. Paid per call ($0.002) via x402.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    var _a;
+    const q = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").replace(/^(price|token|dex)\s+(of\s+)?/i, "").trim();
+    const data = await callStore(runtime, `/crypto/dex?q=${encodeURIComponent(q)}`);
+    if (callback) callback({ text: `DEX data for ${q}: ${JSON.stringify(data)}`, content: data });
+    return true;
+  },
+  examples: []
+};
+var categoryRanking = {
+  name: "AI_CATEGORY_RANKING",
+  similes: ["WHO_DOES_AI_RECOMMEND", "CATEGORY_LEADERBOARD", "BEST_IN_CATEGORY"],
+  description: "Ask which brands AI recommends across a whole category right now, ranked by mention share. Paid per call ($0.02) via x402.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    var _a;
+    const category = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "").replace(/^(who does ai recommend (for|in)|best|ranking for)\s+/i, "").trim();
+    const data = await callStore(runtime, `/category/ranking?category=${encodeURIComponent(category)}`);
+    if (callback) callback({ text: `AI category ranking for ${category}: ${JSON.stringify(data)}`, content: data });
+    return true;
+  },
+  examples: []
+};
+var countryEconomics = {
+  name: "COUNTRY_ECONOMICS",
+  similes: ["GDP", "INFLATION", "MACRO_DATA", "COUNTRY_FINANCE"],
+  description: "Economic indicators (GDP, growth, inflation, unemployment, GDP/capita, population) for 200+ countries. Paid per call ($0.005) via x402.",
+  validate: async () => true,
+  handler: async (runtime, message, _state, _o, callback) => {
+    var _a;
+    const country = (((_a = message == null ? void 0 : message.content) == null ? void 0 : _a.text) || "USA").replace(/[^A-Za-z ]/g, "").trim().slice(0, 40) || "USA";
+    const data = await callStore(runtime, `/macro/country?country=${encodeURIComponent(country)}`);
+    if (callback) callback({ text: `Economic indicators for ${country}: ${JSON.stringify(data)}`, content: data });
+    return true;
+  },
+  examples: []
+};
+var x402AgentStorePlugin = {
+  name: "x402-agentstore",
+  description: "x402 Agent Store data tools for ElizaOS: AI-visibility/GEO, live DEX token data, AI category rankings, prediction-market odds, and country economics \u2014 pay-per-call in USDC via x402, no API keys.",
+  actions: [aiVisibility, dexToken, categoryRanking, countryEconomics],
+  providers: [],
+  evaluators: []
+};
+var index_default = x402AgentStorePlugin;
+export {
+  index_default as default,
+  x402AgentStorePlugin
+};

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@rileycraig/plugin-x402-agentstore",
+  "version": "1.0.0",
+  "description": "ElizaOS plugin: x402 Agent Store data tools — AI-visibility/GEO, live DEX token data, AI category rankings, prediction-market odds, country economics. Pay-per-call in USDC via x402, no API keys.",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "*"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "keywords": ["elizaos", "elizaos-plugin", "x402", "ai-visibility", "geo", "crypto", "dex", "agent", "base", "usdc"],
+  "author": "Riley Craig <rileycraig14@gmail.com>",
+  "license": "MIT",
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0"
+  }
+}