Skip to content

Use web search wording in descriptions and skills (0.3.2) #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pray-mrscraper merged 1 commit into from
Oct 30, 2026
Merged

Use web search wording in descriptions and skills (0.3.2) #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,13 @@
All notable changes to the MrScraper OpenCode plugin are documented here. The
project follows [Semantic Versioning](https://semver.org/).

## 0.3.2 - 2026-10-29

- Reworded search as web search in the package
description, keywords, README, and skills.
The `webSearch` tool is unchanged. The skills now differ from the MrScraper
Claude plugin 0.2.2 only in this wording.

## 0.3.1 - 2026-10-22

- Updated the `mrscraper` skill for the hosted server's three scopes:
Expand Down
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# MrScraper for OpenCode

MrScraper connects [OpenCode](https://opencode.ai) to a hosted MCP server for
retrieving public web pages as HTML, Markdown, or screenshots, Google
discovery, and account usage. The plugin also includes three focused skills
retrieving public web pages as HTML, Markdown, or screenshots, web
search, and account usage. The plugin also includes three focused skills
that help OpenCode choose the right workflow and preserve raw page content.

The same package works in OpenCode 2 and OpenCode 1.
Expand Down Expand Up @@ -152,7 +152,7 @@ OpenCode 2 reaches MCP tools through Code Mode by default.
| Tool | Purpose |
| --- | --- |
| `scraperAPI` | Retrieve a known page as HTML, Markdown, a screenshot, or a combination. |
| `webSearch` | Discover public pages through Google. |
| `webSearch` | Discover public pages through web search. |
| `status` | Inspect subscription status, token usage, and remaining tokens. |

## Retrieve-first routing
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "@mrscraper/opencode",
"version": "0.3.1",
"description": "MrScraper for OpenCode: the hosted MrScraper MCP server plus fetch-first skills for web scraping, structured data extraction, and Google search.",
"version": "0.3.2",
"description": "MrScraper for OpenCode: the hosted MrScraper MCP server plus fetch-first skills for web scraping, structured data extraction, and web search.",
"type": "module",
"main": "index.ts",
"exports": {
Expand All @@ -19,7 +19,7 @@
"web-scraping",
"data-extraction",
"scraping",
"google-search",
"web-search",
"serp",
"mcp",
"research"
Expand Down
14 changes: 7 additions & 7 deletions skills/mrscraper-serp/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: mrscraper-serp
description: |
Discover public pages through Google with MrScraper's webSearch tool using a search query or Google search URL. Use when no target URL is known or the user asks to inspect Google results. After discovery, retrieve selected pages with mrscraper-fetch.
Discover public pages through web search with MrScraper's webSearch tool using a search query or a search results URL. Use when no target URL is known or the user asks to inspect web search results. After discovery, retrieve selected pages with mrscraper-fetch.
---

# Discover Pages with MrScraper MCP Web Search
Expand All @@ -21,14 +21,14 @@ raw=false to receive parsed results:
"raw": false
}

The input can also be a complete Google search URL:
The input can also be a complete search results URL:

{
"url": "https://www.google.com/search?q=web+scraping&gl=us&hl=en&start=20",
"raw": false
}

For a Google URL, the tool reads q, gl, hl, and start. Explicit region,
For a search results URL, the tool reads q, gl, hl, and start. Explicit region,
language, and page inputs take precedence.

## Step 2 — Set Locale and Pagination
Expand Down Expand Up @@ -70,11 +70,11 @@ Use JavaScript rendering for dynamic result features such as AI Overview:

| MCP input | Default | Request mapping | Use |
| --- | --- | --- | --- |
| url | required | Body query | Search query or complete Google search URL. |
| url | required | Body query | Search query or complete search results URL. |
| raw | true | Body format=html | Return result-page HTML; set false to use format. |
| format | json | Body format | json or html when raw=false. |
| region | URL value or omitted | Body region | Google result country, such as us or id. |
| language | URL value or omitted | Body language | Google result language, such as en or id. |
| region | URL value or omitted | Body region | Result country, such as us or id. |
| language | URL value or omitted | Body language | Result language, such as en or id. |
| page | URL value or omitted | Body page | Positive, one-based results page. |
| render_js | false | Body renderJs | Render JavaScript-dependent result features. |
| timeout | 600 | MCP upstream deadline | Maximum wait in seconds; not sent in the search body. |
Expand Down Expand Up @@ -112,5 +112,5 @@ coverage. If the user only requested URL discovery, stop after the search.
- Use [mrscraper](../mrscraper/SKILL.md) when the connection or authentication
fails.

webSearch is for public Google discovery, not for discovering URLs within one
webSearch is for public web search, not for discovering URLs within one
known site.
6 changes: 3 additions & 3 deletions skills/mrscraper/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
name: mrscraper
description: |
Connect, authenticate, route, and troubleshoot MrScraper MCP, and check account usage with the status tool. For known public URLs, retrieve and preserve page content with mrscraper-fetch first; use mrscraper-serp for query-first discovery through Google.
Connect, authenticate, route, and troubleshoot MrScraper MCP, and check account usage with the status tool. For known public URLs, retrieve and preserve page content with mrscraper-fetch first; use mrscraper-serp for query-first discovery through web search.
---

# MrScraper MCP

Use this skill for connection and authentication checks, tool selection, shared
response handling, account status, and troubleshooting. Load the focused fetch
or SERP skill for page retrieval and Google search.
or SERP skill for page retrieval and web search.

## Step 1 — Verify or Connect MrScraper MCP

Expand Down Expand Up @@ -65,7 +65,7 @@ complete.
| User outcome | MCP tool or skill |
| --- | --- |
| Retrieve and preserve a known public page as HTML, Markdown, or a screenshot | [mrscraper-fetch](../mrscraper-fetch/SKILL.md) with scraperAPI |
| Discover relevant pages from a Google query | [mrscraper-serp](../mrscraper-serp/SKILL.md) with webSearch, then retrieve selected pages |
| Discover relevant pages from a web search query | [mrscraper-serp](../mrscraper-serp/SKILL.md) with webSearch, then retrieve selected pages |
| Check the plan, token usage, or remaining tokens | status |

### Retrieve first, extract locally
Expand Down
Loading