alterlab-mcp-server 1.1.0 → 1.1.1

package/README.md

@@ -439,6 +439,33 @@ The MCP server returns helpful error messages with suggested next actions:
 
 ---
 
+## Agentic Workflows — AI Agents That Scrape the Web
+
+AlterLab MCP turns any AI agent into a web-capable agent. Instead of relying on stale training data, your agent can fetch live information from any website during execution.
+
+### Use Cases for AI Agents
+
+- **Research agents** — scrape multiple sources, cross-reference facts, generate reports with citations
+- **Data pipeline agents** — extract structured product/pricing/job data on a schedule
+- **Competitive intelligence** — monitor competitor pages, track pricing changes, detect new features
+- **Content generation** — scrape real data to ground LLM output in facts, not hallucinations
+- **Lead enrichment** — scrape company websites to enrich CRM records with live data
+- **Compliance monitoring** — check regulatory pages, terms of service, and policy updates
+
+### Compatible AI Frameworks and Clients
+
+Works with any tool that supports MCP (Model Context Protocol):
+
+- **Claude Desktop** / **Claude Code** — Anthropic's AI assistant
+- **Cursor** — AI-powered code editor
+- **Windsurf** — Codeium's AI IDE
+- **Cline** — VS Code AI assistant
+- **GitHub Copilot** — via MCP configuration
+- **Custom agents** — any framework using the MCP SDK (Python, TypeScript, Go)
+- **n8n** — workflow automation via [n8n-nodes-alterlab](https://www.npmjs.com/package/n8n-nodes-alterlab)
+
+---
+
 ## Contributing
 
 ```bash

package/dist/index.js

@@ -16,7 +16,7 @@ function createServer(config) {
     const client = new client_js_1.AlterLabClient(config);
     const server = new mcp_js_1.McpServer({
         name: "alterlab",
-        version: "1.1.0",
+        version: "1.1.1",
     });
     // Register tools
     server.tool("alterlab_scrape", scrape_js_1.scrapeDescription, scrape_js_1.scrapeSchema.shape, (params) => (0, scrape_js_1.handleScrape)(client, params));

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "alterlab-mcp-server",
-  "version": "1.1.0",
-  "description": "MCP server for AlterLab web scraping API — scrape, extract, screenshot, and authenticated scraping",
+  "mcpName": "io.alterlab/mcp-server",
+  "version": "1.1.1",
+  "description": "MCP server for web scraping, structured data extraction, and screenshots — give Claude, Cursor, Windsurf, and AI agents the ability to scrape any website with automatic anti-bot bypass",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -14,13 +15,29 @@
   },
   "keywords": [
     "mcp",
-    "scraping",
-    "web-scraping",
-    "alterlab",
+    "mcp-server",
     "model-context-protocol",
+    "web-scraping",
+    "scraping",
+    "scraper",
+    "crawler",
+    "crawling",
+    "data-extraction",
+    "structured-data",
+    "screenshot",
+    "ai-agent",
+    "agentic",
+    "llm",
+    "llm-tools",
     "claude",
     "cursor",
-    "windsurf"
+    "windsurf",
+    "cline",
+    "copilot",
+    "anti-bot",
+    "headless-browser",
+    "proxy",
+    "alterlab"
   ],
   "author": "AlterLab",
   "license": "MIT",
@@ -41,6 +58,7 @@
   },
   "files": [
     "dist",
+    "server.json",
     "README.md",
     "LICENSE"
   ]

package/server.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://registry.modelcontextprotocol.io/schemas/server.json",
+  "name": "io.alterlab/mcp-server",
+  "description": "Web scraping and structured data extraction MCP server. Scrape any website with automatic anti-bot bypass (Cloudflare, DataDome, Akamai), extract structured JSON with AI, take screenshots, and manage authenticated sessions. Works with Claude, Cursor, Windsurf, Cline, and any MCP-compatible AI agent.",
+  "repository": {
+    "url": "https://github.com/RapierCraft/alterlab-mcp-server",
+    "source": "github"
+  },
+  "version_detail": {
+    "version": "1.1.1",
+    "release_date": "2026-03-31",
+    "is_latest": true
+  },
+  "packages": [
+    {
+      "registry_type": "npm",
+      "name": "alterlab-mcp-server",
+      "version": "1.1.1",
+      "runtime": "node",
+      "runtime_arguments": [],
+      "package_arguments": [],
+      "environment_variables": [
+        {
+          "name": "ALTERLAB_API_KEY",
+          "description": "Your AlterLab API key (starts with sk_live_). Get one at https://alterlab.io",
+          "required": true,
+          "is_secret": true
+        },
+        {
+          "name": "ALTERLAB_API_URL",
+          "description": "API base URL (defaults to https://api.alterlab.io)",
+          "required": false,
+          "is_secret": false
+        }
+      ]
+    }
+  ],
+  "tools": [
+    {
+      "name": "alterlab_scrape",
+      "description": "Scrape any website with anti-bot bypass and proxy rotation. Returns clean text, HTML, markdown, or JSON."
+    },
+    {
+      "name": "alterlab_extract",
+      "description": "Extract structured data from any URL using AI. Define a schema and get back typed JSON."
+    },
+    {
+      "name": "alterlab_screenshot",
+      "description": "Take a screenshot of any webpage with configurable viewport and format."
+    },
+    {
+      "name": "alterlab_estimate_cost",
+      "description": "Estimate the credit cost of a scrape before running it."
+    },
+    {
+      "name": "alterlab_check_balance",
+      "description": "Check your current account balance and credit usage."
+    },
+    {
+      "name": "alterlab_list_sessions",
+      "description": "List all active authenticated browser sessions."
+    },
+    {
+      "name": "alterlab_create_session",
+      "description": "Create a new authenticated browser session with cookies for logged-in scraping."
+    },
+    {
+      "name": "alterlab_get_session",
+      "description": "Get details of a specific authenticated session."
+    },
+    {
+      "name": "alterlab_update_session",
+      "description": "Update cookies or settings on an existing session."
+    },
+    {
+      "name": "alterlab_refresh_session",
+      "description": "Refresh an authenticated session to extend its lifetime."
+    },
+    {
+      "name": "alterlab_validate_session",
+      "description": "Validate that a session's cookies are still active and working."
+    },
+    {
+      "name": "alterlab_delete_session",
+      "description": "Delete an authenticated browser session."
+    }
+  ],
+  "remotes": []
+}