mcpscraper-sdk 0.3.0 → 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/README.md +8 -1
- package/dist/index.cjs +19 -0
- package/dist/index.d.cts +3 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.js +22 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -40,6 +40,13 @@ Every non-2xx response throws a `ScraperApiError` with `status`, `code`, and the
|
|
|
40
40
|
|
|
41
41
|
## API surface
|
|
42
42
|
|
|
43
|
+
`client.tools` is the generated, typed 145-tool MCP surface. It includes every scraper, browser, workflow, artifact, billing, and memory tool from `contracts/mcp.tools.json`.
|
|
44
|
+
|
|
45
|
+
```ts
|
|
46
|
+
await client.tools.search.searchSerp({ query: 'roof repair Denver' })
|
|
47
|
+
await client.tools.memory.search({ query: 'roofing warranty terms' })
|
|
48
|
+
```
|
|
49
|
+
|
|
43
50
|
Core operations are flat on the client: `searchSerp`, `harvestPaa`, `extractUrl`, `mapSiteUrls`, `extractSite`, `auditSite`, `getExtractSiteStatus`, `listJobs`, `getJob`, `getHistory`, `getLedger`.
|
|
44
51
|
|
|
45
52
|
Everything else is namespaced by product area, matching the OpenAPI spec's tags: `client.youtube`, `client.screenshot`, `client.facebook`, `client.googleAds`, `client.instagram`, `client.reddit`, `client.video`, `client.maps`, `client.directory`, `client.serpIntelligence`, `client.workflows`.
|
|
@@ -74,4 +81,4 @@ npm run generate
|
|
|
74
81
|
|
|
75
82
|
## See also
|
|
76
83
|
|
|
77
|
-
[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 85-tool typed surface) · [`mcpscraper-sdk`
|
|
84
|
+
[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk`](../memory) (Node, full 85-tool typed surface) · [`mcpscraper-sdk` Python source package](../scraper-python) · [`mcpscraper-cli`](../cli)
|
package/dist/index.cjs
CHANGED
|
@@ -20,6 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
20
20
|
// src/index.ts
|
|
21
21
|
var index_exports = {};
|
|
22
22
|
__export(index_exports, {
|
|
23
|
+
GeneratedMcpToolsClient: () => import_mcpscraper_memory_sdk2.GeneratedMcpToolsClient,
|
|
24
|
+
MCP_TOOL_BINDINGS: () => import_mcpscraper_memory_sdk2.MCP_TOOL_BINDINGS,
|
|
25
|
+
MCP_TOOL_COUNT: () => import_mcpscraper_memory_sdk2.MCP_TOOL_COUNT,
|
|
26
|
+
McpToolError: () => import_mcpscraper_memory_sdk2.McpToolError,
|
|
27
|
+
McpToolsClient: () => import_mcpscraper_memory_sdk2.McpToolsClient,
|
|
23
28
|
ScraperApiError: () => ScraperApiError,
|
|
24
29
|
ScraperClient: () => ScraperClient
|
|
25
30
|
});
|
|
@@ -304,6 +309,7 @@ var ScraperClient = class {
|
|
|
304
309
|
serpIntelligence;
|
|
305
310
|
workflows;
|
|
306
311
|
memoryTools;
|
|
312
|
+
tools;
|
|
307
313
|
constructor(options) {
|
|
308
314
|
this.r = new Requester(options.apiKey, options.baseUrl ?? "https://mcpscraper.dev", options.fetch ?? globalThis.fetch);
|
|
309
315
|
this.youtube = new YoutubeNamespace(this.r);
|
|
@@ -318,6 +324,11 @@ var ScraperClient = class {
|
|
|
318
324
|
this.serpIntelligence = new SerpIntelligenceNamespace(this.r);
|
|
319
325
|
this.workflows = new WorkflowsNamespace(this.r);
|
|
320
326
|
this.memoryTools = new MemoryTools(this.callMemoryTool.bind(this));
|
|
327
|
+
this.tools = new import_mcpscraper_memory_sdk.McpToolsClient({
|
|
328
|
+
apiKey: options.apiKey,
|
|
329
|
+
baseUrl: options.baseUrl ?? "https://mcpscraper.dev",
|
|
330
|
+
fetch: options.fetch
|
|
331
|
+
});
|
|
321
332
|
}
|
|
322
333
|
async callMemoryTool(toolName, args) {
|
|
323
334
|
const result = await this.r.call("POST", "/memory/mcp-call", {
|
|
@@ -364,8 +375,16 @@ var ScraperClient = class {
|
|
|
364
375
|
return this.r.call("GET", "/ledger");
|
|
365
376
|
}
|
|
366
377
|
};
|
|
378
|
+
|
|
379
|
+
// src/index.ts
|
|
380
|
+
var import_mcpscraper_memory_sdk2 = require("mcpscraper-memory-sdk");
|
|
367
381
|
// Annotate the CommonJS export names for ESM import in node:
|
|
368
382
|
0 && (module.exports = {
|
|
383
|
+
GeneratedMcpToolsClient,
|
|
384
|
+
MCP_TOOL_BINDINGS,
|
|
385
|
+
MCP_TOOL_COUNT,
|
|
386
|
+
McpToolError,
|
|
387
|
+
McpToolsClient,
|
|
369
388
|
ScraperApiError,
|
|
370
389
|
ScraperClient
|
|
371
390
|
});
|
package/dist/index.d.cts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { AccessNamespace, CaptureNamespace, ChannelsNamespace, FactsNamespace, GraphNamespace, LibraryNamespace, MemoryNamespace, RecallNamespace, ScheduleNamespace, StorageNamespace, TablesNamespace, TagsNamespace, VaultsNamespace, VideoNamespace as VideoNamespace$1, WebhooksNamespace, CallToolFn } from 'mcpscraper-memory-sdk';
|
|
1
|
+
import { AccessNamespace, CaptureNamespace, ChannelsNamespace, FactsNamespace, GraphNamespace, LibraryNamespace, MemoryNamespace, RecallNamespace, ScheduleNamespace, StorageNamespace, TablesNamespace, TagsNamespace, VaultsNamespace, VideoNamespace as VideoNamespace$1, WebhooksNamespace, CallToolFn, McpToolsClient } from 'mcpscraper-memory-sdk';
|
|
2
|
+
export { GeneratedMcpToolsClient, MCP_TOOL_BINDINGS, MCP_TOOL_COUNT, McpToolDescriptor, McpToolError, McpToolErrorDetails, McpToolsClient, McpToolsClientOptions } from 'mcpscraper-memory-sdk';
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -3332,6 +3333,7 @@ declare class ScraperClient {
|
|
|
3332
3333
|
readonly serpIntelligence: SerpIntelligenceNamespace;
|
|
3333
3334
|
readonly workflows: WorkflowsNamespace;
|
|
3334
3335
|
readonly memoryTools: MemoryTools;
|
|
3336
|
+
readonly tools: McpToolsClient;
|
|
3335
3337
|
constructor(options: ScraperClientOptions);
|
|
3336
3338
|
private callMemoryTool;
|
|
3337
3339
|
searchSerp(params: Omit<RequestBodyOf<'harvestSync'>, 'serpOnly'>): Promise<{
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { AccessNamespace, CaptureNamespace, ChannelsNamespace, FactsNamespace, GraphNamespace, LibraryNamespace, MemoryNamespace, RecallNamespace, ScheduleNamespace, StorageNamespace, TablesNamespace, TagsNamespace, VaultsNamespace, VideoNamespace as VideoNamespace$1, WebhooksNamespace, CallToolFn } from 'mcpscraper-memory-sdk';
|
|
1
|
+
import { AccessNamespace, CaptureNamespace, ChannelsNamespace, FactsNamespace, GraphNamespace, LibraryNamespace, MemoryNamespace, RecallNamespace, ScheduleNamespace, StorageNamespace, TablesNamespace, TagsNamespace, VaultsNamespace, VideoNamespace as VideoNamespace$1, WebhooksNamespace, CallToolFn, McpToolsClient } from 'mcpscraper-memory-sdk';
|
|
2
|
+
export { GeneratedMcpToolsClient, MCP_TOOL_BINDINGS, MCP_TOOL_COUNT, McpToolDescriptor, McpToolError, McpToolErrorDetails, McpToolsClient, McpToolsClientOptions } from 'mcpscraper-memory-sdk';
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -3332,6 +3333,7 @@ declare class ScraperClient {
|
|
|
3332
3333
|
readonly serpIntelligence: SerpIntelligenceNamespace;
|
|
3333
3334
|
readonly workflows: WorkflowsNamespace;
|
|
3334
3335
|
readonly memoryTools: MemoryTools;
|
|
3336
|
+
readonly tools: McpToolsClient;
|
|
3335
3337
|
constructor(options: ScraperClientOptions);
|
|
3336
3338
|
private callMemoryTool;
|
|
3337
3339
|
searchSerp(params: Omit<RequestBodyOf<'harvestSync'>, 'serpOnly'>): Promise<{
|
package/dist/index.js
CHANGED
|
@@ -44,7 +44,8 @@ import {
|
|
|
44
44
|
TagsNamespace,
|
|
45
45
|
VaultsNamespace,
|
|
46
46
|
VideoNamespace as MemoryVideoNamespace,
|
|
47
|
-
WebhooksNamespace
|
|
47
|
+
WebhooksNamespace,
|
|
48
|
+
McpToolsClient
|
|
48
49
|
} from "mcpscraper-memory-sdk";
|
|
49
50
|
var Requester = class {
|
|
50
51
|
constructor(apiKey, baseUrl, fetchImpl) {
|
|
@@ -293,6 +294,7 @@ var ScraperClient = class {
|
|
|
293
294
|
serpIntelligence;
|
|
294
295
|
workflows;
|
|
295
296
|
memoryTools;
|
|
297
|
+
tools;
|
|
296
298
|
constructor(options) {
|
|
297
299
|
this.r = new Requester(options.apiKey, options.baseUrl ?? "https://mcpscraper.dev", options.fetch ?? globalThis.fetch);
|
|
298
300
|
this.youtube = new YoutubeNamespace(this.r);
|
|
@@ -307,6 +309,11 @@ var ScraperClient = class {
|
|
|
307
309
|
this.serpIntelligence = new SerpIntelligenceNamespace(this.r);
|
|
308
310
|
this.workflows = new WorkflowsNamespace(this.r);
|
|
309
311
|
this.memoryTools = new MemoryTools(this.callMemoryTool.bind(this));
|
|
312
|
+
this.tools = new McpToolsClient({
|
|
313
|
+
apiKey: options.apiKey,
|
|
314
|
+
baseUrl: options.baseUrl ?? "https://mcpscraper.dev",
|
|
315
|
+
fetch: options.fetch
|
|
316
|
+
});
|
|
310
317
|
}
|
|
311
318
|
async callMemoryTool(toolName, args) {
|
|
312
319
|
const result = await this.r.call("POST", "/memory/mcp-call", {
|
|
@@ -353,7 +360,21 @@ var ScraperClient = class {
|
|
|
353
360
|
return this.r.call("GET", "/ledger");
|
|
354
361
|
}
|
|
355
362
|
};
|
|
363
|
+
|
|
364
|
+
// src/index.ts
|
|
365
|
+
import {
|
|
366
|
+
McpToolsClient as McpToolsClient2,
|
|
367
|
+
McpToolError,
|
|
368
|
+
MCP_TOOL_BINDINGS,
|
|
369
|
+
MCP_TOOL_COUNT,
|
|
370
|
+
GeneratedMcpToolsClient
|
|
371
|
+
} from "mcpscraper-memory-sdk";
|
|
356
372
|
export {
|
|
373
|
+
GeneratedMcpToolsClient,
|
|
374
|
+
MCP_TOOL_BINDINGS,
|
|
375
|
+
MCP_TOOL_COUNT,
|
|
376
|
+
McpToolError,
|
|
377
|
+
McpToolsClient2 as McpToolsClient,
|
|
357
378
|
ScraperApiError,
|
|
358
379
|
ScraperClient
|
|
359
380
|
};
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcpscraper-sdk",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Official
|
|
3
|
+
"version": "0.4.0",
|
|
4
|
+
"description": "Official Node.js client for all 145 mcpscraper.dev MCP tools and the REST API",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"main": "./dist/index.cjs",
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
"seo-api"
|
|
32
32
|
],
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"mcpscraper-memory-sdk": "^0.
|
|
34
|
+
"mcpscraper-memory-sdk": "^0.3.0"
|
|
35
35
|
},
|
|
36
36
|
"devDependencies": {
|
|
37
37
|
"openapi-typescript": "^7.13.0"
|