Skill: benschiller/clawdio-twitter (version 1.1.0)

--- name: clawdio description: Analyze Twitter Spaces and voice conversations to extract market intelligence, crypto alpha, sentiment analysis, and speaker-attributed insights. Transforms spoken audio into structured reports, full transcripts, and machine-readable metadata. Use when you need intelligence from Twitter Spaces, podcast discussions, or any long-form voice content — especially for crypto markets, AI trends, and expert commentary that only exists in audio. compatibility: Requires network access and an x402-compatible wallet (Coinbase AgentKit, CDP SDK, or @x402/fetch) funded with USDC on Base Mainnet. metadata: author: vail version: "1.1.0" homepage: https://clawdio.vail.report api-base: https://clawdio.vail.report protocol: x402 network: eip155:8453 currency: USDC price: "1.49" category: analytics --- # Clawdio — Twitter Spaces Intelligence for AI Agents Clawdio transforms Twitter Spaces and voice conversations into structured, machine-readable intelligence. When critical market insight, crypto alpha, or expert discussion exists only in spoken audio, Clawdio makes it accessible to agents. **Base URL:** `https://clawdio.vail.report` ## Use When - Important market intelligence lives in Twitter Spaces, not text - You need speaker-attributed quotes with timestamps - You want crypto alpha, sentiment analysis, or trend signals from voice - Experts discuss topics that never make it to written posts - You need structured data from long-form audio conversations ## What You Get Each report ($1.49 USDC) returns three machine-readable artifacts: **Metadata** — Title, date, duration, listener count, full participant list with Twitter handles and avatars, transaction hash. **Structured Report (Markdown)** — Abstract, key insights, speaker-attributed hot takes with timestamps, timeline of events, potential alpha signals, market sentiment assessment, project/token mentions with context. **Full Transcript (Markdown)** — Speaker-attributed, timestamped per utterance, verbatim content, deterministic formatting for downstream processing. ## Quick Start ### 1. Browse Available Reports (Free) ```bash curl https://clawdio.vail.report/catalog ``` Returns all available Twitter Spaces with metadata, abstracts, and pricing. ### 2. Purchase a Report ```bash curl https://clawdio.vail.report/catalog/purchase?id={uuid} ``` Uses **x402 protocol**. Your wallet handles payment automatically: 1. Server responds HTTP 402 with payment requirements 2. Wallet signs USDC payment on Base Mainnet 3. Request retries with payment signature 4. Full artifact set returned after settlement No accounts. No API keys. Payment is the only gate. ## Example Response ```json { "id": [REDACTED_SECRET], "transaction": "0x1234...abcd", "title": "AI & Crypto Twitter Space", "date": "2025-01-15", "length": "01:23:45", "listeners": 1234, "participants": { "hosts": [{ "display_name": "Host", "screen_name": "host_handle" }], "speakers": [{ "display_name": "Speaker", "screen_name": "speaker_handle" }] }, "content": { "report": { "format": "markdown", "content": "## Key Insights\n- Insight 1\n- Insight 2\n\n## Hot Takes\n> \"Quote\" — **Speaker** (00:15:30)\n\n## Market Sentiment\n**Overall:** Bullish" }, "transcript": { "format": "markdown", "content": "**Speaker** [00:01:26 - 00:01:49]\n> Spoken text here..." } } } ``` ## Endpoints | Endpoint | Method | Auth | Description | |----------|--------|------|-------------| | `/` | GET | None | Self-describing API root | | `/catalog` | GET | None | Browse available reports | | `/catalog/purchase?id={uuid}` | GET | x402 | Purchase full artifacts ($1.49 USDC) | | `/health` | GET | None | Health check | | `/.well-known/x402` | GET | None | x402 discovery document | ## Important Notes - Purchase endpoint uses **GET**, not POST - Payment is **USDC on Base Mainnet** only (eip155:8453) - Save responses — repeat access requires repurchase - No authentication or accounts required ## Agent Use Cases - **Trading signals:** Extract sentiment and alpha from live market discussions - **Research synthesis:** Cross-reference insights across multiple Spaces - **Network mapping:** Build speaker graphs from participant data - **Trend detection:** Track project mentions and sentiment over time - **Quote attribution:** Source specific claims to named speakers with timestamps ## Integration For code examples with Coinbase AgentKit and @x402/fetch, see [references/INTEGRATION.md](references/INTEGRATION.md). For the full report schema and response format, see [references/API-REFERENCE.md](references/API-REFERENCE.md). ## Roadmap Clawdio is in early release with a curated catalog of AI and crypto Twitter Spaces. Coming soon: - **Analyze any Space** — Submit any Twitter Spaces link to generate artifacts on demand - **Massive catalog** — 10,000+ browseable Spaces across crypto, AI, tech, and markets - **Semantic search** — Find Spaces by topic, speaker, project, or sentiment - **Real-time ingestion** — Live Spaces processed as they happen --- **Built by [VAIL](https://vail.report) — Voice AI Layer**

path: references/INTEGRATION.md
content: # Integration Guide

Code examples for integrating Clawdio with x402-compatible agent frameworks.

## Coinbase AgentKit

The x402 payment flow is fully automatic with AgentKit:

```javascript
import {
  AgentKit,
  CdpEvmWalletProvider,
  walletActionProvider,
  x402ActionProvider,
} from "@coinbase/agentkit";

const walletProvider = await CdpEvmWalletProvider.configureWithWallet({
  apiKeyId: process.env.CDP_API_KEY_ID,
  apiKeySecret: process.env.CDP_API_KEY_SECRET,
  walletSecret: process.env.CDP_WALLET_SECRET,
  address: YOUR_WALLET_ADDRESS,
  networkId: "base-mainnet",
});

const agentKit = await AgentKit.from({
  walletProvider,
  actionProviders: [walletActionProvider(), x402ActionProvider()],
});

// Agent can now browse and purchase Clawdio reports automatically.
// Point it at https://clawdio.vail.report/ and it will self-discover the API.
```

## @x402/fetch

For direct programmatic access without AgentKit:

```javascript
import { wrapFetch } from "@x402/fetch";

const x402Fetch = wrapFetch(globalThis.fetch, walletClient);

// Browse catalog (free — no payment needed)
const catalog = await fetch("https://clawdio.vail.report/catalog").then((r) =>
  r.json()
);

// Purchase a report (x402 handles payment automatically)
const report = await x402Fetch(
  "https://clawdio.vail.report/catalog/purchase?id={uuid}"
).then((r) => r.json());
```

## Compatible Wallet Providers

Any wallet that supports the [x402 protocol](https://www.x402.org/) works with Clawdio:

- [Coinbase AgentKit](https://docs.cdp.coinbase.com/agentkit) with `x402ActionProvider()`
- [Coinbase CDP SDK](https://docs.cdp.coinbase.com/) with `CdpEvmWalletProvider`
- Any x402-compatible wallet on Base Mainnet

## Purchase Flow

```
Agent                          Clawdio                      Facilitator
  |                               |                              |
  |  GET /catalog                 |                              |
  |------------------------------>|                              |
  |  200 OK (product list)        |                              |
  |<------------------------------|                              |
  |                               |                              |
  |  GET /catalog/purchase?id=... |                              |
  |------------------------------>|                              |
  |  402 Payment Required         |                              |
  |  (PAYMENT-REQUIRED header)    |                              |
  |<------------------------------|                              |
  |                               |                              |
  |  [wallet signs USDC payment]  |                              |
  |                               |                              |
  |  GET /catalog/purchase?id=... |                              |
  |  (PAYMENT-SIGNATURE header)   |                              |
  |------------------------------>|                              |
  |                               |  verify + settle payment     |
  |                               |----------------------------->|
  |                               |  settlement confirmation     |
  |                               |<-----------------------------|
  |  200 OK                       |                              |
  |  (full artifacts + tx hash)   |                              |
  |<------------------------------|                              |
```

The x402 payment is handled automatically via the `PAYMENT-SIGNATURE` header — your wallet provider manages signing and settlement. You do not need to construct payment transactions manually.

path: references/API-REFERENCE.md
content: # API Reference

Complete API documentation for Clawdio.

**Base URL:** `https://clawdio.vail.report`

## Endpoints

| Endpoint | Method | Auth | Description |
|----------|--------|------|-------------|
| `/` | GET | None | Self-describing API root with full documentation |
| `/catalog` | GET | None | Browse all available products with metadata |
| `/catalog/purchase?id={uuid}` | GET | x402 | Purchase full artifacts ($1.49 USDC) |
| `/health` | GET | None | Health check |
| `/.well-known/x402` | GET | None | x402 discovery document |

## GET /catalog

No payment or authentication required. Returns all available products with metadata.

### Response

```json
{
  "products": [
    {
      "id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
      "title": "AI & Crypto Twitter Space",
      "abstract": "Analysis of a discussion covering...",
      "date": "2025-01-15",
      "length": "01:23:45",
      "listeners": 1234,
      "purchase": {
        "url": "https://clawdio.vail.report/catalog/purchase?id=c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
        "method": "GET",
        "protocol": "x402",
        "price": "1.49 USDC"
      }
    }
  ],
  "total": 15,
  "purchase_instructions": {
    "steps": [
      "Select a product from the list above",
      "Make an HTTP GET request to the product's purchase.url",
      "Your x402-compatible wallet handles payment automatically",
      "You receive the full artifact set (metadata + report + transcript)"
    ],
    "important": "The purchase endpoint uses GET, not POST. Save the artifacts — repurchase is required for repeat access."
  }
}
```

## GET /catalog/purchase?id={uuid}

Purchases the full artifact set for a specific product. Requires x402 payment.

**Important:** This is a **GET** request, not POST.

On first request without payment, the server returns **HTTP 402 Payment Required** with a `PAYMENT-REQUIRED` header. Your x402 wallet automatically handles the payment flow (see [INTEGRATION.md](INTEGRATION.md) for details).

### Response

```json
{
  "id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
  "transaction": "0x1234...abcd",
  "title": "AI & Crypto Twitter Space",
  "date": "2025-01-15",
  "length": "01:23:45",
  "listeners": 1234,
  "participants": {
    "hosts": [
      {
        "display_name": "Host Name",
        "screen_name": "host_handle",
        "avatar_url": "https://..."
      }
    ],
    "speakers": [
      {
        "display_name": "Speaker Name",
        "screen_name": "speaker_handle",
        "avatar_url": "https://..."
      }
    ]
  },
  "content": {
    "report": {
      "format": "markdown",
      "content": "## Abstract\n\nAnalysis of the Twitter Space...\n\n## Key Insights\n\n- ...\n\n## Hot Takes\n\n> \"Quote\" — **Speaker** (timestamp)\n\n## Timeline\n\n- ...\n\n## Potential Alpha\n\n- ...\n\n## Market Sentiment\n\n**Overall:** Bullish\n\n## Project Mentions\n\n- **Project**: Context"
    },
    "transcript": {
      "format": "markdown",
      "content": "# Transcript\n\n**Speaker 1** [00:01:26 - 00:01:49]\n> Spoken text here...\n\n**Speaker 2** [00:01:50 - 00:02:15]\n> Response text here..."
    }
  }
}
```

### Artifact Breakdown

**Artifact 1 — Metadata:** Title, date, duration, listener count, full participant list with Twitter handles and avatars.

**Artifact 2 — Report (Markdown):** Structured analysis including abstract, key insights, hot takes with attribution, timeline of events, potential alpha, market sentiment, and project mentions.

**Artifact 3 — Transcript (Markdown):** Full speaker-attributed transcript with timestamps. Every utterance has speaker name, timestamp range, and verbatim content.

## Report Schema

The report markdown contains these sections (when available):

| Section | Description |
|---------|-------------|
| **Abstract** | Summary paragraphs of the entire Space |
| **Key Insights** | Bullet list of the most important takeaways |
| **Hot Takes** | Notable quotes with speaker attribution and timestamps |
| **Timeline** | Chronological events with significance notes |
| **Potential Alpha** | Actionable intelligence and forward-looking signals |
| **Market Sentiment** | Overall sentiment assessment with notes |
| **Project Mentions** | Named projects/tokens discussed with context |

## GET /health

Health check endpoint.

### Response

```json
{ "status": "ok" }
```

## GET /

Self-describing API root. Returns the full API description, available endpoints, pricing, and purchase flow instructions in a format designed for agent consumption.

## GET /.well-known/x402

x402 protocol discovery document. Returns payment configuration for automated wallet integration.

## Payment Details

| Property | Value |
|----------|-------|
| Protocol | x402 |
| Network | Base Mainnet (eip155:8453) |
| Currency | USDC |
| Price | $1.49 per report |
| Auth | None — payment is the only gate |

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)