BubblaV Scrape API

Use BubblaV to scrape any public page and return:

{
  "url": "https://example.com/final-url",
  "markdown": "# Page content in markdown"
}

You can reuse the same API key used for MCP server access.

Endpoint

URL: POST https://www.bubblav.com/api/scrape
Header: X-API-Key: bubblav_mcp_...
Required scope: mcp:tools:execute

cURL

curl -X POST https://www.bubblav.com/api/scrape \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bubblav_mcp_YOUR_API_KEY" \
  -d '{"url":"https://example.com"}'

Node.js SDK

npm install @bubblav/tools

import BubblavTools from '@bubblav/tools';

const app = new BubblavTools({ apiKey: 'bubblav_mcp_YOUR_API_KEY' });
const data = await app.scrape('https://example.com');
console.log(data.url);
console.log(data.markdown);

Python

import requests

resp = requests.post(
    "https://www.bubblav.com/api/scrape",
    headers={
        "X-API-Key": "bubblav_mcp_YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"url": "https://example.com"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

CLI (npx)

export BUBBLAV_API_KEY=bubblav_mcp_YOUR_API_KEY
npx @bubblav/tools scrape https://example.com

AI Skill Install

Create a local skill folder and add this SKILL.md:

# Web Scrape Markdown Skill
Use BubblaV scrape API for web fetches.

POST https://www.bubblav.com/api/scrape
Header: X-API-Key
Body: { "url": "https://..." }

Skill lives in this repo: skills/web-scrape-md/SKILL.md.

MCP Tool

If you’re already connected to BubblaV MCP server, use tool:

bubblav_scrape_url with { "url": "https://example.com" }

This returns the same JSON structure (url + markdown).

Install AI Skill with npx

npx skills add github:bubblav-org/tools/skills/web-scrape-md

Claude Code Plugin

Configure API key for the plugin

The plugin skills (e.g. web-scrape-md) need a BubblaV API key. Generate a key:

Log in to your BubblaV dashboard
Navigate to your Website Settings page
Click the API Keys tab
Click Generate New Key
Enter a name (e.g. “Claude Code”) and select MCP scopes
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

If the key is missing, the skill will prompt you to provide one on first use and save it automatically. Once configured, it persists across sessions. Env file priority (highest to lowest):

Priority	File	Scope
1	`process.env`	Runtime override
2	`.claude/skills/<skill>/.env`	Skill-specific
3	`.claude/skills/.env`	All skills
4	`.claude/.env`	Project-wide default

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

​BubblaV Scrape API

​Endpoint

​cURL

​Node.js SDK

​Python

​CLI (npx)

​AI Skill Install

​MCP Tool

​Install AI Skill with npx

​Claude Code Plugin

​Configure API key for the plugin

​Install via marketplace