@mrscraper/opencode 0.3.2 → 0.4.0

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 CHANGED
@@ -3,6 +3,16 @@
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.4.0 - 2026-11-02
7
+
8
+ - Updated the `mrscraper-serp` skill for MrScraper MCP server 0.3.0, which
9
+ moved `webSearch` to MrScraper's new web search endpoint. Results are a
10
+ ranked list (rank, title, url, description, source); `region` sets the
11
+ results' country and the new `num_results` asks for 10 to 100 results. The
12
+ `raw`, `format`, `language`, `page`, and `render_js` options are gone, and
13
+ so is the search results URL example. Skills are identical to the MrScraper
14
+ Claude plugin 0.3.0.
15
+
6
16
  ## 0.3.2 - 2026-10-29
7
17
 
8
18
  - Reworded search as web search in the package
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrscraper/opencode",
3
- "version": "0.3.2",
3
+ "version": "0.4.0",
4
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",
@@ -158,8 +158,8 @@ account usage, not the progress of a request.
158
158
  replaced by scraperAPI, webSearch, and status.
159
159
  - Page incomplete or missing dynamic content: load mrscraper-fetch and revise
160
160
  page-loading inputs deliberately.
161
- - Search results weak: load mrscraper-serp and refine the query, locale, or
162
- page.
161
+ - Search results weak: load mrscraper-serp and refine the query, country, or
162
+ number of results.
163
163
 
164
164
  ## Limits
165
165
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: mrscraper-serp
3
3
  description: |
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.
4
+ Discover public pages through web search with MrScraper's webSearch tool. 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
@@ -13,86 +13,58 @@ status, or broader routing.
13
13
 
14
14
  ## Step 1 — Build the Query
15
15
 
16
- Include the important entity, attribute, location, or date in url, and set
17
- raw=false to receive parsed results:
16
+ Pass the query in url. Include the important entity, attribute, location, or
17
+ date:
18
18
 
19
19
  {
20
- "url": "web scraping best practices",
21
- "raw": false
20
+ "url": "web scraping best practices"
22
21
  }
23
22
 
24
- The input can also be a complete search results URL:
23
+ The input can also be a search results URL; its q parameter becomes the query.
25
24
 
26
- {
27
- "url": "https://www.google.com/search?q=web+scraping&gl=us&hl=en&start=20",
28
- "raw": false
29
- }
30
-
31
- For a search results URL, the tool reads q, gl, hl, and start. Explicit region,
32
- language, and page inputs take precedence.
33
-
34
- ## Step 2 — Set Locale and Pagination
25
+ ## Step 2 — Set the Country and Result Count
35
26
 
36
- Set both country and language when results must match a locale:
27
+ Set region to a two-letter country code when results must come from one
28
+ country. It defaults to us:
37
29
 
38
30
  {
39
31
  "url": "running shoes",
40
- "raw": false,
41
- "region": "id",
42
- "language": "id",
43
- "page": 2
44
- }
45
-
46
- Start with the first page unless the user requests broader coverage. Inspect
47
- the current page before requesting another.
48
-
49
- ## Step 3 — Choose the Output
50
-
51
- raw defaults to true, which returns result-page HTML as the Python SDK does.
52
- Set raw=false for parsed JSON; organic results are in data.data.organic, next
53
- to sections such as people_also_ask and pagination.
54
-
55
- Request result-page HTML when the page itself is needed:
56
-
57
- {
58
- "url": "iphone 17"
32
+ "region": "id"
59
33
  }
60
34
 
61
- Use JavaScript rendering for dynamic result features such as AI Overview:
35
+ The search returns 10 results by default. Ask for more, up to 100, only when
36
+ the user needs broader coverage:
62
37
 
63
38
  {
64
- "url": "what is web scraping",
65
- "raw": false,
66
- "render_js": true
39
+ "url": "running shoes",
40
+ "region": "id",
41
+ "num_results": 30
67
42
  }
68
43
 
69
44
  ### Parameters
70
45
 
71
46
  | MCP input | Default | Request mapping | Use |
72
47
  | --- | --- | --- | --- |
73
- | url | required | Body query | Search query or complete search results URL. |
74
- | raw | true | Body format=html | Return result-page HTML; set false to use format. |
75
- | format | json | Body format | json or html when raw=false. |
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
- | page | URL value or omitted | Body page | Positive, one-based results page. |
79
- | render_js | false | Body renderJs | Render JavaScript-dependent result features. |
48
+ | url | required | Body query | Search query, or a search results URL whose q value is used. |
49
+ | region | us | Body country | Two-letter result country, such as us or id. |
50
+ | num_results | 10 | Body numResults | Number of results, from 10 to 100; fewer may come back. |
80
51
  | timeout | 600 | MCP upstream deadline | Maximum wait in seconds; not sent in the search body. |
81
52
 
82
53
  Authentication is handled by the MCP client's OAuth 2.1 connection and is
83
54
  never a tool input.
84
55
 
85
- ## Step 4 — Inspect the Results
56
+ ## Step 3 — Inspect the Results
86
57
 
87
58
  The complete response envelope is available in MCP structuredContent and as
88
59
  formatted JSON text. Prefer structuredContent. Check isError, error, and
89
- status_code before using data.
60
+ status_code before using data. The results are a ranked list in data.data;
61
+ each result has rank, title, url, description, and source.
90
62
 
91
63
  When the user requests a search artifact, save the successful data or full
92
64
  envelope with local file-writing capability; webSearch has no output-path
93
65
  input.
94
66
 
95
- ## Step 5 — Continue with Relevant URLs
67
+ ## Step 4 — Continue with Relevant URLs
96
68
 
97
69
  Select only URLs relevant to the user's goal, then load
98
70
  [mrscraper-fetch](../mrscraper-fetch/SKILL.md) to retrieve and inspect each
@@ -102,12 +74,11 @@ Run independent follow-up URLs in parallel when the environment supports safe
102
74
  parallel execution. Keep the number of pages proportional to the requested
103
75
  coverage. If the user only requested URL discovery, stop after the search.
104
76
 
105
- ## Step 6 — Handle Weak or Missing Results
77
+ ## Step 5 — Handle Weak or Missing Results
106
78
 
107
- - Set both region and language when the locale is wrong.
79
+ - Set region when the results come from the wrong country.
108
80
  - Rewrite noisy queries around the important entity, attribute, and location.
109
- - Request another result page only after checking the current page.
110
- - Retry once with render_js=true when a dynamic result feature is required.
81
+ - Raise num_results only after checking the first results.
111
82
  - Increase timeout when the MCP request deadline is too short.
112
83
  - Use [mrscraper](../mrscraper/SKILL.md) when the connection or authentication
113
84
  fails.