@newsriver/eliza-plugin

The official ElizaOS plugin for the NewsRiver Global Intelligence API.

Connects your Eliza agent to NewsRiver's global news intelligence platform — 277+ sources across 137 countries, AI-generated briefings, semantic vector search, and secure Web2 proxies (email, SMS, scraping).

Installation

npm install @newsriver/eliza-plugin

Authentication

Option 1: API Key (Subscription)

Get an API key from NewsRiver and add it to your .env:

NEWSRIVER_API_KEY=nrk_live_your_key_here

Security: Keys are SHA-256 hashed server-side. Never stored in plaintext. Analytics logs mask keys to last 4 chars only.

Option 2: x402 Micropayments (No API Key)

If your Eliza agent has a wallet on Base network, it can handle HTTP 402 responses and pay per-request in USDC. Requires @x402/core.

⚠️ Spending Safety: Use a limited allowance contract (e.g., PaySponge) to cap spending. Never give the agent full wallet access.

Usage

import { newsRiverPlugin } from "@newsriver/eliza-plugin";

const myAgent = {
  name: "CryptoTraderBot",
  plugins: [newsRiverPlugin]
};

Actions (7)

| Action | Cost | Description | |---|---|---| | GET_NEWSRIVER_INTELLIGENCE | $0.02–$0.10 | Fetch AI intelligence briefings (hourly=$0.02, daily/weekly/monthly=$0.10) | | SEARCH_NEWSRIVER | $0.001 | Semantic vector search across all articles | | GET_NEWSRIVER_ARTICLES | $0.001 | Fetch latest news articles | | GET_NEWSRIVER_TRENDS | $0.001 | Sentiment trend timelines for any topic | | NEWSRIVER_SEND_EMAIL | $0.05 | Send email via proxy (50/hr limit) | | NEWSRIVER_SEND_SMS | $0.25 | Send SMS via proxy (10/hr limit) | | NEWSRIVER_SCRAPE | $0.10 | Scrape public webpages (SSRF-protected) |

⚠️ Outbound Proxy Actions

NEWSRIVER_SEND_EMAIL and NEWSRIVER_SEND_SMS send real messages. The agent should always confirm with the user before executing these actions. The API enforces:

• Hardcoded sender identity ([email protected])
• Rate limits per IP and per wallet
• SMS messages prefixed with [NewsRiver Agent]

Testing with Dry-Run

Test any action for free using the X-Dry-Run: true header. Returns mock data labeled [SAMPLE]:

curl -H "X-Dry-Run: true" https://api.yieldcircle.app/api/v1/articles

Links

• API Docs: https://agent.yieldcircle.app/#docs
• Pricing: https://agent.yieldcircle.app/#pricing
• Support: [email protected]