@bubblav/tools

BubblaV SDK and CLI for scraping public pages into markdown with the BubblaV API.

Install

npm install @bubblav/tools

SDK

import BubblavTools from '@bubblav/tools';

const client = new BubblavTools({
  apiKey: process.env.BUBBLAV_API_KEY,
});

const result = await client.scrape('https://example.com');
console.log(result.markdown);

CLI

Set your API key first:

export BUBBLAV_API_KEY=bubblav_mcp_YOUR_API_KEY

Scrape a page:

npx @bubblav/tools scrape https://example.com

Install skills:

npx skills add https://github.com/bubblav-org/tools --skill web-scrape-md
npx skills add https://github.com/bubblav-org/tools --skill manage-custom-tools

Skills

web-scrape-md

Scrape a public URL into markdown for AI context. Activates when you ask to read or scrape a web page.

manage-custom-tools

Create and manage custom webhook tools for your BubblaV chatbot via the MCP server. Activates when you ask to add, update, delete, or manage custom tools for your chatbot.

Example prompts:

• "Add a custom tool to my chatbot that finds tournaments near a city"
• "List my custom tools"
• "Update the endpoint for my search tool"

Requires: Pro plan or higher.

Claude Code Plugin

Install via marketplace

Add the BubblaV marketplace and install the plugin:

/plugin marketplace add bubblav-org/tools

Then browse and install from the Discover tab, or install directly:

/plugin install bubblav-tools@bubblav-org-tools

After installing, reload to activate:

/reload-plugins

Configure API key

1. Log in to your BubblaV dashboard 2. Navigate to your Website Settings page 3. Click the API Keys tab 4. Click Generate New Key 5. Enter a name (e.g. "Claude Code") and select MCP scopes 6. Click Generate and copy the key immediately — it won't be shown again

Then set it in your project's .claude/.env file:

# .claude/.env
BUBBLAV_API_KEY=bubblav_mcp_YOUR_API_KEY

The skill will prompt you for the key on first use if it's not configured. Once saved to .claude/.env, it persists across sessions.