clawdio

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.

Security Scan

The skill's stated purpose (audio analysis with paid reports) is plausible, but the integration docs imply the agent will need access to sensitive wallet credentials that the skill metadata does not declare — an inconsistency that deserves caution before installing or granting access.

Purpose & Capability

The skill claims to provide paid transcripts and analysis of Twitter Spaces via a network API — that purpose reasonably requires network access and a payment-capable wallet. However, the SKILL.md and registry metadata list no required environment variables or primary credential, while the integration examples show usage of wallet SDKs that typically require API keys/secrets and a wallet secret. The mismatch between claimed requirements and integration examples is noteworthy.

Instruction Scope

Runtime instructions direct the agent to browse and purchase artifacts from https://clawdio.vail.report using an x402 payment flow. The purchase flow relies on an x402-compatible wallet to sign payments automatically; integration docs show code that expects credential-bearing environment variables (e.g., CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET). The SKILL.md does not instruct how the agent should obtain or protect those credentials, and the agent would need the ability to sign transactions (i.e., access secrets or an interactive wallet). That expands the attack surface: granting the agent wallet signing capability effectively grants it funds-access to the wallet used.

Install Mechanism

This is an instruction-only skill with no install spec and no code files — lowest-risk from an install perspective. Nothing is downloaded or executed on disk by the skill itself.

Credentials

Registry metadata declares no required environment variables, but the INTEGRATION.md demonstrates reliance on Coinbase AgentKit / CDP SDK environment variables (process.env.CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET, wallet address). These are highly sensitive and are not declared in the skill requirements. The lack of a declared 'primary credential' or explicit guidance about which secrets are necessary is an inconsistency and raises the risk of inadvertent credential exposure if the user provides them to enable automation.

Persistence & Privilege

always:false (default) and model invocation is allowed (default). Autonomous invocation is normal for skills, but combined with the need to sign payments/wallet access, it increases blast radius—an agent that can autonomously purchase reports could spend wallet funds without interactive confirmation unless the hosting environment enforces wallet UX prompts. The skill does not request persistent installation privileges or modify other skills.

What to consider before installing

This skill appears to be what it claims (a paid audio-analysis API), but the integration docs indicate your agent will need a signing-capable wallet and may require storing wallet API keys/secrets in environment variables even though the skill metadata doesn't declare them. Before installing or enabling automation: (1) Confirm exactly which credentials the agent will need and insist the skill metadata be updated to list required env vars; (2) If you enable automated purchases, use a dedicated, minimally funded wallet (or a wallet provider that requires explicit user confirmation for each spend) — do not expose your primary exchange or high-value wallet secrets; (3) Consider using an interactive wallet UX rather than giving the agent direct secret access; (4) Be aware GET /catalog/purchase is state-changing and purchase URLs or headers could be logged by intermediaries; (5) Verify the service domain (https://clawdio.vail.report) and TLS before sending funds; (6) If you need higher assurance, request the author add explicit declarations of required environment variables and a security/privacy statement about transcript contents and retention.

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)

curl https://clawdio.vail.report/catalog

Returns all available Twitter Spaces with metadata, abstracts, and pricing.

2. Purchase a Report

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

{
  "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", "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.

For the full report schema and response format, see 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 — Voice AI Layer