Documentation Index
Fetch the complete documentation index at: https://docs.bubblav.com/llms.txt
Use this file to discover all available pages before exploring further.
BubblaV Scrape API
Use BubblaV to scrape any public page and return:
{
"url": "https://example.com/final-url",
"markdown": "# Page content in markdown"
}
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://..." }
skills/web-scrape-md/SKILL.md.
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
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
| 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
/plugin install bubblav-tools@bubblav-org-tools
