@bubblav/tools
BubblaV SDK and CLI for scraping public pages into markdown with the BubblaV API.
Install
npm install @bubblav/toolsSDK
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_KEYScrape a page:
npx @bubblav/tools scrape https://example.comInstall 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-toolsSkills
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/toolsThen browse and install from the Discover tab, or install directly:
/plugin install bubblav-tools@bubblav-org-toolsAfter installing, reload to activate:
/reload-pluginsConfigure 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_KEYThe skill will prompt you for the key on first use if it's not configured. Once saved to .claude/.env, it persists across sessions.
