@fouradata/mcp 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/README.md +24 -5
- package/dist/http.js +13 -1
- package/dist/http.js.map +1 -1
- package/dist/landing.d.ts +2 -0
- package/dist/landing.js +36 -0
- package/dist/landing.js.map +1 -0
- package/dist/server.js +1 -1
- package/dist/tools/auto.js +1 -1
- package/dist/tools/browser.js +1 -1
- package/dist/tools/proxy.js +1 -1
- package/dist/tools/single.js +1 -1
- package/package.json +8 -3
package/README.md
CHANGED
|
@@ -1,12 +1,27 @@
|
|
|
1
|
+
<!-- mcp-name: ai.foura/mcp -->
|
|
1
2
|
# @fouradata/mcp
|
|
2
3
|
|
|
4
|
+
[](https://www.npmjs.com/package/@fouradata/mcp)
|
|
5
|
+
[](https://www.npmjs.com/package/@fouradata/mcp)
|
|
6
|
+
[](https://www.npmjs.com/package/@fouradata/mcp)
|
|
7
|
+
[](./LICENSE)
|
|
8
|
+
|
|
3
9
|
[FourA Web Scraping API](https://foura.ai/) as four [Model Context Protocol](https://modelcontextprotocol.io) tools plus six built-in workflow prompts. Plug it into Claude Desktop, Claude Code, Cursor, Windsurf, or any other MCP client and fetch arbitrary public web pages, bypass anti-bot challenges, and render JavaScript-heavy sites - without writing a line of integration code.
|
|
4
10
|
|
|
5
|
-
Four tools, six prompts, one API key.
|
|
11
|
+
Four tools, six prompts, one API key. One smart `foura_auto` tool picks the fetch method for you (direct, proxy, or full browser); drop to the primitives when you want explicit control. Published to npm with build [provenance](https://docs.npmjs.com/generating-provenance-statements) - the tarball is cryptographically traceable to this repo and CI run.
|
|
12
|
+
|
|
13
|
+
**One-click install:**
|
|
14
|
+
|
|
15
|
+
[](cursor://anysphere.cursor-deeplink/mcp/install?name=foura&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBmb3VyYWRhdGEvbWNwIl0sImVudiI6eyJGT1VSQV9BUElfS0VZIjoiWU9VUl9GT1VSQV9BUElfS0VZIn19)
|
|
16
|
+
[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522foura%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540fouradata%252Fmcp%2522%255D%252C%2522env%2522%253A%257B%2522FOURA_API_KEY%2522%253A%2522YOUR_FOURA_API_KEY%2522%257D%257D)
|
|
17
|
+
|
|
18
|
+
Both buttons pre-fill the config with a `YOUR_FOURA_API_KEY` placeholder - replace it with your key. Or by hand: `claude mcp add foura -- npx -y @fouradata/mcp` (set `FOURA_API_KEY` in env first). Full per-client setup below.
|
|
19
|
+
|
|
20
|
+
[FourA](https://foura.ai) - [MCP page](https://foura.ai/mcp) - [GitHub](https://github.com/fouradata/mcp) - [npm](https://www.npmjs.com/package/@fouradata/mcp) - [Docs](https://foura.ai/docs/mcp/server) - [Hosted endpoint](https://mcp.foura.ai/mcp)
|
|
6
21
|
|
|
7
22
|
## Quick Start - local stdio (recommended for Claude Desktop)
|
|
8
23
|
|
|
9
|
-
Grab a key at [foura.ai/dashboard
|
|
24
|
+
Grab a key at [foura.ai/dashboard/#api-keys](https://foura.ai/dashboard/#api-keys) (one click, shown once on creation, format `pk_live_...`). Then drop this into your MCP client's config:
|
|
10
25
|
|
|
11
26
|
```json
|
|
12
27
|
{
|
|
@@ -162,7 +177,7 @@ Full recipe text + manual fallback prompts: [foura.ai/docs/mcp/recipes](https://
|
|
|
162
177
|
|
|
163
178
|
Your `Bearer` token (or the `FOURA_API_KEY` env var in stdio mode) forwards to the FourA API as `X-API-Key`. One key, all four tools.
|
|
164
179
|
|
|
165
|
-
Keys are managed in the [dashboard](https://foura.ai/dashboard
|
|
180
|
+
Keys are managed in the [dashboard](https://foura.ai/dashboard/#api-keys) - shown once on creation, rotate or deactivate any time. See [foura.ai/docs/getting-started/authentication](https://foura.ai/docs/getting-started/authentication) for the full key-management walkthrough.
|
|
166
181
|
|
|
167
182
|
## Error envelope - typed contract for agent retries
|
|
168
183
|
|
|
@@ -261,7 +276,7 @@ Configurable environment:
|
|
|
261
276
|
| `FOURA_API_BASE` | `https://api.foura.ai/api` | Upstream FourA REST base URL |
|
|
262
277
|
| `FOURA_MCP_PAYLOADS_DIR` | `/data/payloads` | Where ≥50 KB responses are cached on disk |
|
|
263
278
|
|
|
264
|
-
|
|
279
|
+
The full source is public here under MIT - build the container from the included [`Dockerfile`](./Dockerfile) (`docker build -t foura-mcp .`), or run it straight from npm with `npx -y @fouradata/mcp`. See [DEVELOPMENT.md](./DEVELOPMENT.md) for the local build and test workflow.
|
|
265
280
|
|
|
266
281
|
## License
|
|
267
282
|
|
|
@@ -269,10 +284,14 @@ MIT. See [`LICENSE`](./LICENSE).
|
|
|
269
284
|
|
|
270
285
|
## Links
|
|
271
286
|
|
|
287
|
+
- FourA (web scraping API): <https://foura.ai>
|
|
288
|
+
- MCP server page: <https://foura.ai/mcp>
|
|
289
|
+
- Source (GitHub): <https://github.com/fouradata/mcp>
|
|
290
|
+
- npm package: <https://www.npmjs.com/package/@fouradata/mcp>
|
|
272
291
|
- API documentation: <https://foura.ai/docs>
|
|
273
292
|
- MCP server reference: <https://foura.ai/docs/mcp/server>
|
|
274
293
|
- MCP error codes: <https://foura.ai/docs/mcp/errors>
|
|
275
294
|
- MCP recipes: <https://foura.ai/docs/mcp/recipes>
|
|
276
295
|
- REST API errors: <https://foura.ai/docs/api/errors>
|
|
277
296
|
- MCP specification: <https://modelcontextprotocol.io>
|
|
278
|
-
- Get a key: <https://foura.ai/dashboard
|
|
297
|
+
- Get a key: <https://foura.ai/dashboard/#api-keys>
|
package/dist/http.js
CHANGED
|
@@ -3,8 +3,9 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
|
|
|
3
3
|
import { SUPPORTED_PROTOCOL_VERSIONS } from "@modelcontextprotocol/sdk/types.js";
|
|
4
4
|
import { createServer } from "./server.js";
|
|
5
5
|
import { withApiKey } from "./auth.js";
|
|
6
|
+
import { LANDING_REDIRECT, LLMS_TXT } from "./landing.js";
|
|
6
7
|
const PORT = Number(process.env.PORT ?? 3076);
|
|
7
|
-
const SERVER_VERSION = "0.
|
|
8
|
+
const SERVER_VERSION = "0.4.0";
|
|
8
9
|
// Spec MUSTs covered in this file:
|
|
9
10
|
// Origin + Host validation (CVE-2025-66414 DNS rebinding)
|
|
10
11
|
// WWW-Authenticate on 401
|
|
@@ -110,6 +111,17 @@ function validateProtocolVersion(req, res, next) {
|
|
|
110
111
|
app.get("/healthz", (_req, res) => {
|
|
111
112
|
res.json({ ok: true, name: "foura-mcp", version: SERVER_VERSION });
|
|
112
113
|
});
|
|
114
|
+
// Public discovery surfaces (no auth, no Origin/Host gate - like /healthz).
|
|
115
|
+
// The human landing lives at foura.ai/mcp, so a browser hitting the bare root
|
|
116
|
+
// is redirected there (301 = permanent, consolidates SEO onto the one page).
|
|
117
|
+
// llms.txt stays here: mcp.foura.ai is a separate host, so crawlers hitting
|
|
118
|
+
// mcp.foura.ai/llms.txt should find a map without following the redirect.
|
|
119
|
+
app.get("/", (_req, res) => {
|
|
120
|
+
res.redirect(301, LANDING_REDIRECT);
|
|
121
|
+
});
|
|
122
|
+
app.get("/llms.txt", (_req, res) => {
|
|
123
|
+
res.type("text/plain").send(LLMS_TXT);
|
|
124
|
+
});
|
|
113
125
|
function extractBearer(req) {
|
|
114
126
|
const auth = req.header("authorization");
|
|
115
127
|
if (auth?.toLowerCase().startsWith("bearer "))
|
package/dist/http.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,OAA2D,MAAM,SAAS,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
export declare const LANDING_REDIRECT = "https://foura.ai/mcp";
|
|
2
|
+
export declare const LLMS_TXT = "# FourA MCP server\n\n> The FourA web scraping API as a Model Context Protocol (MCP) server. One smart tool fetches any public web page - direct request, rotating proxy, or full browser - and gets past anti-bot challenges. Four tools, six prompts, one API key. Hosted at https://mcp.foura.ai/mcp (Streamable HTTP) and on npm as @fouradata/mcp (local stdio).\n\n## Connect\n- Hosted (Streamable HTTP): POST https://mcp.foura.ai/mcp with header \"Authorization: Bearer pk_live_...\"\n- Local (stdio): npx -y @fouradata/mcp with env FOURA_API_KEY\n- Get an API key: https://foura.ai/dashboard#api-keys\n- Landing + configurator: https://foura.ai/mcp\n\n## Tools\n- foura_auto: smart fetch, picks direct / proxy / browser for you (the default)\n- foura_single: one fast HTTP request (static pages, JSON APIs)\n- foura_proxy: rotating proxy pool with retry (bypass WAF challenges)\n- foura_browser: full browser session with JavaScript rendering\n\n## Prompts\nsmart_fetch, scrape_product_page, extract_article, monitor_pricing, check_endpoint_health, bulk_fetch_urls\n\n## Docs\n- MCP server reference: https://foura.ai/docs/mcp/server\n- Recipes: https://foura.ai/docs/mcp/recipes\n- Error codes: https://foura.ai/docs/mcp/errors\n- Source (GitHub, MIT): https://github.com/fouradata/mcp\n- npm package: https://www.npmjs.com/package/@fouradata/mcp\n";
|
package/dist/landing.js
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
// Discovery surfaces for the hosted server (mcp.foura.ai).
|
|
2
|
+
//
|
|
3
|
+
// The human-facing landing lives on the main site at https://foura.ai/mcp
|
|
4
|
+
// (a real page with the site chrome, theme, and i18n). This host is the MCP
|
|
5
|
+
// endpoint; a browser hitting the bare root is redirected there (the reverse
|
|
6
|
+
// proxy also does this at the edge). We keep the machine-readable llms.txt here
|
|
7
|
+
// because mcp.foura.ai is a separate host and crawlers hitting
|
|
8
|
+
// mcp.foura.ai/llms.txt should find a map without following the redirect.
|
|
9
|
+
export const LANDING_REDIRECT = "https://foura.ai/mcp";
|
|
10
|
+
export const LLMS_TXT = `# FourA MCP server
|
|
11
|
+
|
|
12
|
+
> The FourA web scraping API as a Model Context Protocol (MCP) server. One smart tool fetches any public web page - direct request, rotating proxy, or full browser - and gets past anti-bot challenges. Four tools, six prompts, one API key. Hosted at https://mcp.foura.ai/mcp (Streamable HTTP) and on npm as @fouradata/mcp (local stdio).
|
|
13
|
+
|
|
14
|
+
## Connect
|
|
15
|
+
- Hosted (Streamable HTTP): POST https://mcp.foura.ai/mcp with header "Authorization: Bearer pk_live_..."
|
|
16
|
+
- Local (stdio): npx -y @fouradata/mcp with env FOURA_API_KEY
|
|
17
|
+
- Get an API key: https://foura.ai/dashboard#api-keys
|
|
18
|
+
- Landing + configurator: https://foura.ai/mcp
|
|
19
|
+
|
|
20
|
+
## Tools
|
|
21
|
+
- foura_auto: smart fetch, picks direct / proxy / browser for you (the default)
|
|
22
|
+
- foura_single: one fast HTTP request (static pages, JSON APIs)
|
|
23
|
+
- foura_proxy: rotating proxy pool with retry (bypass WAF challenges)
|
|
24
|
+
- foura_browser: full browser session with JavaScript rendering
|
|
25
|
+
|
|
26
|
+
## Prompts
|
|
27
|
+
smart_fetch, scrape_product_page, extract_article, monitor_pricing, check_endpoint_health, bulk_fetch_urls
|
|
28
|
+
|
|
29
|
+
## Docs
|
|
30
|
+
- MCP server reference: https://foura.ai/docs/mcp/server
|
|
31
|
+
- Recipes: https://foura.ai/docs/mcp/recipes
|
|
32
|
+
- Error codes: https://foura.ai/docs/mcp/errors
|
|
33
|
+
- Source (GitHub, MIT): https://github.com/fouradata/mcp
|
|
34
|
+
- npm package: https://www.npmjs.com/package/@fouradata/mcp
|
|
35
|
+
`;
|
|
36
|
+
//# sourceMappingURL=landing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"landing.js","sourceRoot":"","sources":["../src/landing.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,gFAAgF;AAChF,+DAA+D;AAC/D,0EAA0E;AAE1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBvB,CAAC"}
|
package/dist/server.js
CHANGED
package/dist/tools/auto.js
CHANGED
|
@@ -296,7 +296,7 @@ export function registerAutoTool(server) {
|
|
|
296
296
|
headers: {
|
|
297
297
|
"X-API-Key": getApiKey(),
|
|
298
298
|
"Content-Type": "application/json",
|
|
299
|
-
"User-Agent": "foura-mcp/0.
|
|
299
|
+
"User-Agent": "foura-mcp/0.4.0 (auto)",
|
|
300
300
|
},
|
|
301
301
|
body: JSON.stringify(upstreamBody),
|
|
302
302
|
headersTimeout: 200_000,
|
package/dist/tools/browser.js
CHANGED
|
@@ -216,7 +216,7 @@ export function registerBrowserTool(server) {
|
|
|
216
216
|
headers: {
|
|
217
217
|
"X-API-Key": getApiKey(),
|
|
218
218
|
"Content-Type": "application/json",
|
|
219
|
-
"User-Agent": "foura-mcp/0.
|
|
219
|
+
"User-Agent": "foura-mcp/0.4.0 (browser)",
|
|
220
220
|
},
|
|
221
221
|
body: JSON.stringify(upstreamBody),
|
|
222
222
|
});
|
package/dist/tools/proxy.js
CHANGED
|
@@ -271,7 +271,7 @@ export function registerProxyTool(server) {
|
|
|
271
271
|
headers: {
|
|
272
272
|
"X-API-Key": getApiKey(),
|
|
273
273
|
"Content-Type": "application/json",
|
|
274
|
-
"User-Agent": "foura-mcp/0.
|
|
274
|
+
"User-Agent": "foura-mcp/0.4.0 (proxy)",
|
|
275
275
|
},
|
|
276
276
|
body: JSON.stringify(upstreamBody),
|
|
277
277
|
});
|
package/dist/tools/single.js
CHANGED
|
@@ -267,7 +267,7 @@ export function registerSingleTool(server) {
|
|
|
267
267
|
headers: {
|
|
268
268
|
"X-API-Key": getApiKey(),
|
|
269
269
|
"Content-Type": "application/json",
|
|
270
|
-
"User-Agent": "foura-mcp/0.
|
|
270
|
+
"User-Agent": "foura-mcp/0.4.0 (single)",
|
|
271
271
|
},
|
|
272
272
|
body: JSON.stringify(upstreamBody),
|
|
273
273
|
});
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fouradata/mcp",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "MCP server for the FourA web scraping API
|
|
3
|
+
"version": "0.4.0",
|
|
4
|
+
"description": "MCP server for the FourA web scraping API - four tools (smart auto-fetch, HTTP request, rotating proxies, full browser) plus six prompts, usable from any MCP client.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/server.js",
|
|
7
7
|
"bin": {
|
|
@@ -50,7 +50,12 @@
|
|
|
50
50
|
},
|
|
51
51
|
"keywords": [
|
|
52
52
|
"mcp",
|
|
53
|
+
"mcp-server",
|
|
53
54
|
"model-context-protocol",
|
|
55
|
+
"claude",
|
|
56
|
+
"cursor",
|
|
57
|
+
"ai-agents",
|
|
58
|
+
"llm-tools",
|
|
54
59
|
"foura",
|
|
55
60
|
"web-scraping",
|
|
56
61
|
"scraping-api",
|
|
@@ -63,7 +68,7 @@
|
|
|
63
68
|
"type": "git",
|
|
64
69
|
"url": "git+https://github.com/fouradata/mcp.git"
|
|
65
70
|
},
|
|
66
|
-
"homepage": "https://foura.ai/
|
|
71
|
+
"homepage": "https://foura.ai/mcp",
|
|
67
72
|
"bugs": {
|
|
68
73
|
"url": "https://github.com/fouradata/mcp/issues"
|
|
69
74
|
}
|