@mrscraper/opencode 0.3.0 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/README.md +3 -3
- package/package.json +3 -3
- package/skills/mrscraper/SKILL.md +6 -6
- package/skills/mrscraper-serp/SKILL.md +7 -7
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,22 @@
|
|
|
3
3
|
All notable changes to the MrScraper OpenCode plugin are documented here. The
|
|
4
4
|
project follows [Semantic Versioning](https://semver.org/).
|
|
5
5
|
|
|
6
|
+
## 0.3.2 - 2026-10-29
|
|
7
|
+
|
|
8
|
+
- Reworded search as web search in the package
|
|
9
|
+
description, keywords, README, and skills.
|
|
10
|
+
The `webSearch` tool is unchanged. The skills now differ from the MrScraper
|
|
11
|
+
Claude plugin 0.2.2 only in this wording.
|
|
12
|
+
|
|
13
|
+
## 0.3.1 - 2026-10-22
|
|
14
|
+
|
|
15
|
+
- Updated the `mrscraper` skill for the hosted server's three scopes:
|
|
16
|
+
`scraperAPI` needs `scrape:write`, `webSearch` needs `scrape:read`, and
|
|
17
|
+
`status` needs `account:read`. If `scraperAPI` returns 403
|
|
18
|
+
`insufficient_scope`, run `opencode mcp auth mrscraper` again so OpenCode
|
|
19
|
+
requests `scrape:write`. Skills are identical to the MrScraper Claude plugin
|
|
20
|
+
0.2.2.
|
|
21
|
+
|
|
6
22
|
## 0.3.0 - 2026-10-14
|
|
7
23
|
|
|
8
24
|
- Updated the skills for the hosted MCP server's new tools: `scraperAPI`
|
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# MrScraper for OpenCode
|
|
2
2
|
|
|
3
3
|
MrScraper connects [OpenCode](https://opencode.ai) to a hosted MCP server for
|
|
4
|
-
retrieving public web pages as HTML, Markdown, or screenshots,
|
|
5
|
-
|
|
4
|
+
retrieving public web pages as HTML, Markdown, or screenshots, web
|
|
5
|
+
search, and account usage. The plugin also includes three focused skills
|
|
6
6
|
that help OpenCode choose the right workflow and preserve raw page content.
|
|
7
7
|
|
|
8
8
|
The same package works in OpenCode 2 and OpenCode 1.
|
|
@@ -152,7 +152,7 @@ OpenCode 2 reaches MCP tools through Code Mode by default.
|
|
|
152
152
|
| Tool | Purpose |
|
|
153
153
|
| --- | --- |
|
|
154
154
|
| `scraperAPI` | Retrieve a known page as HTML, Markdown, a screenshot, or a combination. |
|
|
155
|
-
| `webSearch` | Discover public pages through
|
|
155
|
+
| `webSearch` | Discover public pages through web search. |
|
|
156
156
|
| `status` | Inspect subscription status, token usage, and remaining tokens. |
|
|
157
157
|
|
|
158
158
|
## Retrieve-first routing
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mrscraper/opencode",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "MrScraper for OpenCode: the hosted MrScraper MCP server plus fetch-first skills for web scraping, structured data extraction, and
|
|
3
|
+
"version": "0.3.2",
|
|
4
|
+
"description": "MrScraper for OpenCode: the hosted MrScraper MCP server plus fetch-first skills for web scraping, structured data extraction, and web search.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.ts",
|
|
7
7
|
"exports": {
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
"web-scraping",
|
|
20
20
|
"data-extraction",
|
|
21
21
|
"scraping",
|
|
22
|
-
"
|
|
22
|
+
"web-search",
|
|
23
23
|
"serp",
|
|
24
24
|
"mcp",
|
|
25
25
|
"research"
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mrscraper
|
|
3
3
|
description: |
|
|
4
|
-
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
|
|
4
|
+
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.
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# MrScraper MCP
|
|
8
8
|
|
|
9
9
|
Use this skill for connection and authentication checks, tool selection, shared
|
|
10
10
|
response handling, account status, and troubleshooting. Load the focused fetch
|
|
11
|
-
or SERP skill for page retrieval and
|
|
11
|
+
or SERP skill for page retrieval and web search.
|
|
12
12
|
|
|
13
13
|
## Step 1 — Verify or Connect MrScraper MCP
|
|
14
14
|
|
|
@@ -47,9 +47,9 @@ Never place credentials in tool arguments, print them, write them into project
|
|
|
47
47
|
artifacts, or manually reproduce the OAuth exchange. Do not configure an
|
|
48
48
|
API-key or bearer-token fallback from these skills.
|
|
49
49
|
|
|
50
|
-
The connection uses
|
|
51
|
-
account:read for status. A tool called without its scope returns
|
|
52
|
-
insufficient_scope; reauthorize the connection so the client requests it.
|
|
50
|
+
The connection uses three scopes: scrape:write for scraperAPI, scrape:read for
|
|
51
|
+
webSearch, and account:read for status. A tool called without its scope returns
|
|
52
|
+
403 insufficient_scope; reauthorize the connection so the client requests it.
|
|
53
53
|
|
|
54
54
|
Verify end-to-end access with status, which reads the account without
|
|
55
55
|
retrieving a page:
|
|
@@ -65,7 +65,7 @@ complete.
|
|
|
65
65
|
| User outcome | MCP tool or skill |
|
|
66
66
|
| --- | --- |
|
|
67
67
|
| Retrieve and preserve a known public page as HTML, Markdown, or a screenshot | [mrscraper-fetch](../mrscraper-fetch/SKILL.md) with scraperAPI |
|
|
68
|
-
| Discover relevant pages from a
|
|
68
|
+
| Discover relevant pages from a web search query | [mrscraper-serp](../mrscraper-serp/SKILL.md) with webSearch, then retrieve selected pages |
|
|
69
69
|
| Check the plan, token usage, or remaining tokens | status |
|
|
70
70
|
|
|
71
71
|
### Retrieve first, extract locally
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mrscraper-serp
|
|
3
3
|
description: |
|
|
4
|
-
Discover public pages through
|
|
4
|
+
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.
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Discover Pages with MrScraper MCP Web Search
|
|
@@ -21,14 +21,14 @@ raw=false to receive parsed results:
|
|
|
21
21
|
"raw": false
|
|
22
22
|
}
|
|
23
23
|
|
|
24
|
-
The input can also be a complete
|
|
24
|
+
The input can also be a complete search results URL:
|
|
25
25
|
|
|
26
26
|
{
|
|
27
27
|
"url": "https://www.google.com/search?q=web+scraping&gl=us&hl=en&start=20",
|
|
28
28
|
"raw": false
|
|
29
29
|
}
|
|
30
30
|
|
|
31
|
-
For a
|
|
31
|
+
For a search results URL, the tool reads q, gl, hl, and start. Explicit region,
|
|
32
32
|
language, and page inputs take precedence.
|
|
33
33
|
|
|
34
34
|
## Step 2 — Set Locale and Pagination
|
|
@@ -70,11 +70,11 @@ Use JavaScript rendering for dynamic result features such as AI Overview:
|
|
|
70
70
|
|
|
71
71
|
| MCP input | Default | Request mapping | Use |
|
|
72
72
|
| --- | --- | --- | --- |
|
|
73
|
-
| url | required | Body query | Search query or complete
|
|
73
|
+
| url | required | Body query | Search query or complete search results URL. |
|
|
74
74
|
| raw | true | Body format=html | Return result-page HTML; set false to use format. |
|
|
75
75
|
| format | json | Body format | json or html when raw=false. |
|
|
76
|
-
| region | URL value or omitted | Body region |
|
|
77
|
-
| language | URL value or omitted | Body language |
|
|
76
|
+
| region | URL value or omitted | Body region | Result country, such as us or id. |
|
|
77
|
+
| language | URL value or omitted | Body language | Result language, such as en or id. |
|
|
78
78
|
| page | URL value or omitted | Body page | Positive, one-based results page. |
|
|
79
79
|
| render_js | false | Body renderJs | Render JavaScript-dependent result features. |
|
|
80
80
|
| timeout | 600 | MCP upstream deadline | Maximum wait in seconds; not sent in the search body. |
|
|
@@ -112,5 +112,5 @@ coverage. If the user only requested URL discovery, stop after the search.
|
|
|
112
112
|
- Use [mrscraper](../mrscraper/SKILL.md) when the connection or authentication
|
|
113
113
|
fails.
|
|
114
114
|
|
|
115
|
-
webSearch is for public
|
|
115
|
+
webSearch is for public web search, not for discovering URLs within one
|
|
116
116
|
known site.
|