docs: add monitor.activity(), fix API base URL, update skill to just-scrape

- Add monitor.activity() tick-history docs to Python SDK, JS SDK, and MCP server
- Fix API base URL from /v2 to /api/v2 across all SDK and MCP docs
- Rename SGAI_TIMEOUT_S → SGAI_TIMEOUT (with legacy alias noted)
- Update Claude Code skill to reference just-scrape CLI and new install paths
- Bump MCP server tool count from 17 → 18

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: VinciGit00

integrations/claude-code-skill.mdx

@@ -6,14 +6,16 @@ icon: '/logo/claude-color.svg'
 
 ## Overview
 
-The ScrapeGraphAI [Claude Code Skill](https://github.com/ScrapeGraphAI/skill) gives AI coding agents full access to ScrapeGraphAI's web scraping, search, and crawling APIs. Once installed, agents like Claude Code, Cursor, Copilot, and Cline can scrape websites, extract structured data, and crawl pages — all from natural language prompts.
+The ScrapeGraphAI Claude Code Skill ships with [just-scrape](https://github.com/ScrapeGraphAI/just-scrape), the official CLI for the **v2 API**. Once installed, agents like Claude Code, Cursor, Copilot, Cline, and Windsurf can scrape websites, extract structured data, search the web, crawl sites, and set up page-change monitors — all from natural language prompts.
+
+The skill wires `just-scrape` into your agent's skill directory so the agent knows when and how to invoke the CLI.
 
 <Card
   title="GitHub Repository"
   icon="github"
-  href="https://github.com/ScrapeGraphAI/skill"
+  href="https://github.com/ScrapeGraphAI/just-scrape"
 >
-  View the skill source code and documentation
+  Browse the CLI and skill source
 </Card>
 
 ## Installation
@@ -22,21 +24,25 @@ The ScrapeGraphAI [Claude Code Skill](https://github.com/ScrapeGraphAI/skill) gi
 
 ### Option 1: Install via skills.sh (Recommended)
 
-The fastest way to install. Requires [Node.js](https://nodejs.org).
+The fastest way to install. Requires [Node.js](https://nodejs.org) or [Bun](https://bun.sh).
 
 ```bash
-npx skills add ScrapeGraphAI/skill
+bunx skills add https://github.com/ScrapeGraphAI/just-scrape
+# or
+npx skills add https://github.com/ScrapeGraphAI/just-scrape
 ```
 
-This clones the skill and symlinks it into your `~/.claude/skills/` directory automatically.
+This symlinks `skills/just-scrape/SKILL.md` into your `~/.claude/skills/` directory automatically.
+
+You can also browse the published skill at [skills.sh/scrapegraphai/just-scrape/just-scrape](https://skills.sh/scrapegraphai/just-scrape/just-scrape).
 
 ### Option 2: Manual install
 
 Clone the repository and create the symlink yourself:
 
 ```bash
-git clone https://github.com/ScrapeGraphAI/skill.git ~/.claude/skills/scrapegraphai
-ln -sf ~/.claude/skills/scrapegraphai/SKILL.md ~/.claude/skills/scrapegraphai.md
+git clone https://github.com/ScrapeGraphAI/just-scrape.git ~/.claude/skills/just-scrape
+ln -sf ~/.claude/skills/just-scrape/skills/just-scrape/SKILL.md ~/.claude/skills/just-scrape.md
 ```
 
 ### Option 3: Project-level install
@@ -45,58 +51,54 @@ Install the skill for a single project only:
 
 ```bash
 mkdir -p .claude/skills
-git clone https://github.com/ScrapeGraphAI/skill.git .claude/skills/scrapegraphai
-ln -sf .claude/skills/scrapegraphai/SKILL.md .claude/skills/scrapegraphai.md
+git clone https://github.com/ScrapeGraphAI/just-scrape.git .claude/skills/just-scrape
+ln -sf .claude/skills/just-scrape/skills/just-scrape/SKILL.md .claude/skills/just-scrape.md
 ```
 
 </Steps>
 
 ## Setup
 
-Set your ScrapeGraphAI API key as an environment variable:
+Install the CLI and set your ScrapeGraphAI API key:
 
 ```bash
+npm install -g just-scrape@latest
 export SGAI_API_KEY="sgai-..."
 ```
 
 <Note>
-Get your API key from the [dashboard](https://scrapegraphai.com/dashboard).
+Get your API key from the [dashboard](https://scrapegraphai.com/dashboard). The CLI also accepts the key via a `.env` file, `~/.scrapegraphai/config.json`, or an interactive prompt.
 </Note>
 
-## What's Included
-
-The skill installs the following files:
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Main skill file with API reference, examples, and decision guide |
-| `references/api-endpoints.md` | Full parameter tables for all endpoints |
-| `references/sdk-examples.md` | Python and JavaScript SDK examples |
-| `references/advanced-features.md` | Stealth mode, schemas, scrolling, pagination, and more |
-
 ## Capabilities
 
+The skill maps to the v2 API surface via `just-scrape`:
+
 <CardGroup cols={2}>
-  <Card title="SmartScraper" icon="wand-magic-sparkles">
-    Extract structured data from any webpage using natural language prompts
+  <Card title="extract" icon="wand-magic-sparkles">
+    Extract structured data from any URL using AI (`just-scrape extract`)
   </Card>
-  <Card title="SearchScraper" icon="magnifying-glass">
-    Search the web and extract results with AI or as markdown
+  <Card title="search" icon="magnifying-glass">
+    Search the web and extract structured results (`just-scrape search`)
   </Card>
-  <Card title="Markdownify" icon="file-code">
-    Convert any webpage into clean, formatted markdown
+  <Card title="scrape" icon="file-code">
+    Fetch a page in 8 formats: markdown, html, screenshot, branding, links, images, summary, json
   </Card>
-  <Card title="SmartCrawler" icon="spider">
-    Crawl multiple pages from a website with depth and path controls
+  <Card title="markdownify" icon="file-lines">
+    Convert any webpage into clean markdown (wraps `scrape -f markdown`)
   </Card>
-  <Card title="Sitemap" icon="sitemap">
-    Extract all URLs from a website's sitemap
+  <Card title="crawl" icon="spider">
+    Crawl multi-page sites with depth, link, and pattern controls
   </Card>
-  <Card title="Agentic Scraper" icon="robot">
-    Browser automation — login, click, navigate, fill forms, then extract
+  <Card title="monitor" icon="clock">
+    Schedule page-change monitors with cron intervals, webhooks, and activity polling
   </Card>
 </CardGroup>
 
+<Note>
+Removed from v1: `sitemap`, `agentic_scraper`, `generate-schema`, `validate`. There is no direct replacement on v2.
+</Note>
+
 ## Example Prompts
 
 Once the skill is installed, you can use natural language prompts directly in your AI coding agent:
@@ -118,14 +120,18 @@ Crawl https://example.com/blog with depth 2 and extract the title and summary fr
 ```
 
 ```text
-Get all URLs from the sitemap of https://example.com
+Monitor https://store.example.com/pricing every hour and webhook me when it changes
+```
+
+```text
+Create a 30m monitor on https://example.com and poll its activity feed, printing new ticks as they come in
 ```
 
 ```text
-Log into https://example.com/dashboard, click "Reports", and extract the table data
+Fetch a full-page screenshot and branding assets for https://example.com
 ```
 
-The agent will automatically select the right ScrapeGraphAI endpoint, handle authentication, poll for async results, and return structured data.
+The agent will automatically select the right `just-scrape` command, handle authentication, poll for async results (crawls), and return structured data.
 
 ## Supported Agents
 
@@ -146,7 +152,7 @@ Need help with the skill?
   <Card
     title="GitHub Issues"
     icon="github"
-    href="https://github.com/ScrapeGraphAI/skill/issues"
+    href="https://github.com/ScrapeGraphAI/just-scrape/issues"
   >
     Report bugs and request features
   </Card>

sdks/javascript.mdx

@@ -349,6 +349,32 @@ await monitor.resume("your-api-key", cronId);
 await monitor.delete("your-api-key", cronId);
 ```
 
+#### monitor.activity() — poll tick history
+
+Paginate through per-run ticks for a monitor (what changed on each scheduled run).
+
+```javascript
+import { monitor } from "scrapegraph-js";
+
+const activity = await monitor.activity("your-api-key", cronId, { limit: 20 });
+
+if (activity.status === "success") {
+  for (const tick of activity.data?.ticks ?? []) {
+    const changed = tick.changed ? "CHANGED" : "no change";
+    console.log(`[${tick.createdAt}] ${tick.status} - ${changed} (${tick.elapsedMs}ms)`);
+  }
+
+  if (activity.data?.nextCursor) {
+    const next = await monitor.activity("your-api-key", cronId, {
+      limit: 20,
+      cursor: activity.data.nextCursor,
+    });
+  }
+}
+```
+
+Params: `limit` (1–100, default `20`), `cursor` (opaque pagination token). Each tick has `id`, `createdAt`, `status`, `changed`, `elapsedMs`, and `diffs` with per-format deltas.
+
 ### getCredits
 
 Check your account credit balance.
@@ -436,9 +462,9 @@ if (result.status === "success") {
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `SGAI_API_URL` | Override API base URL | `https://api.scrapegraphai.com/v2` |
+| `SGAI_API_URL` | Override API base URL | `https://api.scrapegraphai.com/api/v2` |
 | `SGAI_DEBUG` | Enable debug logging (`"1"`) | off |
-| `SGAI_TIMEOUT_S` | Request timeout in seconds | `120` |
+| `SGAI_TIMEOUT` | Request timeout in seconds | `120` |
 
 ## Support
 

sdks/python.mdx

@@ -71,12 +71,12 @@ class ApiResult(BaseModel, Generic[T]):
 
 ### Environment Variables
 
-| Variable          | Description                                  | Default                              |
-| ----------------- | -------------------------------------------- | ------------------------------------ |
-| `SGAI_API_KEY`    | Your ScrapeGraphAI API key                   | —                                    |
-| `SGAI_API_URL`    | Override API base URL                        | `https://api.scrapegraphai.com/v2`   |
-| `SGAI_TIMEOUT_S`  | Request timeout in seconds                   | `120`                                |
-| `SGAI_DEBUG`      | Enable debug logging (set to `"1"`)          | off                                  |
+| Variable        | Description                                  | Default                                 |
+| --------------- | -------------------------------------------- | --------------------------------------- |
+| `SGAI_API_KEY`  | Your ScrapeGraphAI API key                   | —                                       |
+| `SGAI_API_URL`  | Override API base URL                        | `https://api.scrapegraphai.com/api/v2`  |
+| `SGAI_TIMEOUT`  | Request timeout in seconds                   | `120`                                   |
+| `SGAI_DEBUG`    | Enable debug logging (set to `"1"`)          | off                                     |
 
 The client supports context managers for automatic session cleanup:
 
@@ -310,6 +310,28 @@ sgai.monitor.resume(cron_id)
 sgai.monitor.delete(cron_id)
 ```
 
+#### `monitor.activity()` — poll tick history
+
+Paginate through the per-run ticks a monitor has produced (what changed on each scheduled run).
+
+```python
+from scrapegraph_py import MonitorActivityRequest
+
+act = sgai.monitor.activity(cron_id, MonitorActivityRequest(limit=20))
+
+if act.status == "success":
+    for tick in act.data.ticks:
+        status = "CHANGED" if tick.changed else "no change"
+        print(f"[{tick.created_at}] {tick.status} - {status} ({tick.elapsed_ms}ms)")
+
+    if act.data.next_cursor:
+        more = sgai.monitor.activity(
+            cron_id, MonitorActivityRequest(limit=20, cursor=act.data.next_cursor),
+        )
+```
+
+`MonitorActivityRequest` fields: `limit` (1–100, default `20`) and optional `cursor` for pagination. Each `MonitorTickEntry` exposes `id`, `created_at`, `status`, `changed`, `elapsed_ms`, and a `diffs` model with per-format deltas.
+
 #### `MonitorCreateRequest` fields
 
 | Field          | Type                      | Required | Description                                    |

services/mcp-server.mdx

@@ -22,8 +22,8 @@ A production‑ready Model Context Protocol (MCP) server that connects LLMs to t
 
 ## Key Features
 
-- Full v2 API coverage: scrape, extract, search, crawl (+ stop/resume), monitor lifecycle, credits, history, and schema generation
-- Uses the v2 API base URL (`https://api.scrapegraphai.com/v2`) with the `SGAI-APIKEY` header — wire format matches [scrapegraph-py v2](https://github.com/ScrapeGraphAI/scrapegraph-py/pull/84)
+- Full v2 API coverage: scrape, extract, search, crawl (+ stop/resume), monitor lifecycle (+ activity polling), credits, history, and schema generation
+- Uses the v2 API base URL (`https://api.scrapegraphai.com/api/v2`) with the `SGAI-APIKEY` header — wire format matches [scrapegraph-py v2](https://github.com/ScrapeGraphAI/scrapegraph-py/pull/84)
 - Remote HTTP MCP endpoint and local Python server support
 - Works with Cursor, Claude Desktop, and any MCP‑compatible client
 - Robust error handling, timeouts, and production‑tested reliability
@@ -176,9 +176,10 @@ The server reads the ScrapeGraph API key from `SGAI_API_KEY` (local) or the `X-A
 | Variable | Description | Default |
 |---|---|---|
 | `SGAI_API_KEY` | ScrapeGraph API key | — |
-| `SGAI_API_URL` | Override the v2 API base URL | `https://api.scrapegraphai.com/v2` |
-| `SGAI_TIMEOUT_S` | Request timeout in seconds | `120` |
+| `SGAI_API_URL` | Override the v2 API base URL | `https://api.scrapegraphai.com/api/v2` |
+| `SGAI_TIMEOUT` | Request timeout in seconds | `120` |
 | `SCRAPEGRAPH_API_BASE_URL` | Legacy alias for `SGAI_API_URL` (still honored) | — |
+| `SGAI_TIMEOUT_S` | Legacy alias for `SGAI_TIMEOUT` (still honored) | — |
 
 ## Available Tools
 
@@ -316,8 +317,15 @@ monitor_get(monitor_id: str)
 monitor_pause(monitor_id: str)
 monitor_resume(monitor_id: str)
 monitor_delete(monitor_id: str)
+monitor_activity(
+  monitor_id: str,
+  limit: int | None = None,         # 1–100, default 20
+  cursor: str | None = None,        # pagination cursor
+)
 ```
 
+`monitor_activity` returns the tick history (`id`, `createdAt`, `status`, `changed`, `elapsedMs`, `diffs`) plus a `nextCursor` when more results are available — mirrors `sgai.monitor.activity()` in the SDKs.
+
 ### Account tools
 
 #### credits

services/mcp-server/introduction.mdx

@@ -22,8 +22,8 @@ The Model Context Protocol (MCP) is a standardized way for AI assistants to acce
 ## Key Features
 
 <CardGroup cols={2}>
-  <Card title="17 Powerful Tools" icon="tools">
-    Scrape, extract, search, crawl, generate schemas, monitor scheduled jobs, and manage your account
+  <Card title="18 Powerful Tools" icon="tools">
+    Scrape, extract, search, crawl, generate schemas, monitor scheduled jobs (with activity polling), and manage your account
   </Card>
   <Card title="Remote & Local" icon="server">
     Use the hosted HTTP endpoint or run locally via Python
@@ -59,6 +59,7 @@ The MCP server exposes the following tools via API v2:
 | **monitor_pause** | Pause a running monitor (POST /monitor/:id/pause) |
 | **monitor_resume** | Resume a paused monitor (POST /monitor/:id/resume) |
 | **monitor_delete** | Delete a monitor (DELETE /monitor/:id) |
+| **monitor_activity** | Poll tick history for a monitor with pagination (GET /monitor/:id/activity) |
 
 <Note>
   Removed from v1: `sitemap`, `agentic_scrapper`, `markdownify_status`, `smartscraper_status` (no v2 API equivalents).