@mcp-b/smart-dom-reader 1.0.3-beta.0 → 1.0.3-beta.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/README.md +101 -3
- package/dist/index.d.ts.map +1 -1
- package/package.json +29 -11
package/README.md
CHANGED
|
@@ -1,6 +1,35 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @mcp-b/smart-dom-reader
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Token-efficient DOM extraction for AI agents - Extract interactive elements, semantic structure, and stable CSS selectors for LLM-powered browser automation
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@mcp-b/smart-dom-reader)
|
|
6
|
+
[](https://www.npmjs.com/package/@mcp-b/smart-dom-reader)
|
|
7
|
+
[](https://opensource.org/licenses/MIT)
|
|
8
|
+
[](https://www.typescriptlang.org/)
|
|
9
|
+
[](https://bundlephobia.com/package/@mcp-b/smart-dom-reader)
|
|
10
|
+
|
|
11
|
+
📖 **[Full Documentation](https://docs.mcp-b.ai/packages/smart-dom-reader)** | 🚀 **[Quick Start](https://docs.mcp-b.ai/quickstart)**
|
|
12
|
+
|
|
13
|
+
**@mcp-b/smart-dom-reader** extracts DOM structure optimized for AI/LLM consumption. Get stable CSS selectors, interactive elements, and semantic page structure while minimizing token usage. Perfect for AI-powered browser automation, userscript generation, and web scraping with Claude, ChatGPT, or any LLM.
|
|
14
|
+
|
|
15
|
+
## Why Use @mcp-b/smart-dom-reader?
|
|
16
|
+
|
|
17
|
+
| Feature | Benefit |
|
|
18
|
+
|---------|---------|
|
|
19
|
+
| **Token-Efficient** | Progressive extraction minimizes LLM context window usage |
|
|
20
|
+
| **Stable Selectors** | Ranked CSS selectors (ID > data-testid > ARIA > classes) for reliable automation |
|
|
21
|
+
| **AI-Optimized Output** | Structured data designed for LLM understanding |
|
|
22
|
+
| **Zero Dependencies** | Lightweight, runs in any browser environment |
|
|
23
|
+
| **Shadow DOM Support** | Traverses shadow roots and iframes |
|
|
24
|
+
| **Stateless API** | Works with any document context - Puppeteer, Playwright, browser extensions |
|
|
25
|
+
|
|
26
|
+
## Use Cases
|
|
27
|
+
|
|
28
|
+
- **AI Browser Automation**: Generate robust selectors for Puppeteer/Playwright scripts
|
|
29
|
+
- **Userscript Generation**: LLMs create browser automation scripts with stable selectors
|
|
30
|
+
- **Web Scraping**: Extract structured data with semantic context for AI processing
|
|
31
|
+
- **Test Automation**: Generate reliable test selectors with multiple fallback strategies
|
|
32
|
+
- **Accessibility Analysis**: Extract ARIA labels, roles, and semantic landmarks
|
|
4
33
|
|
|
5
34
|
## Key Features
|
|
6
35
|
|
|
@@ -367,6 +396,56 @@ This library is designed to provide:
|
|
|
367
396
|
7. **Context Preservation**: Maintains element relationships
|
|
368
397
|
8. **Framework Agnostic**: Works with any web application
|
|
369
398
|
|
|
399
|
+
## Frequently Asked Questions
|
|
400
|
+
|
|
401
|
+
### How is this different from Cheerio or jsdom?
|
|
402
|
+
|
|
403
|
+
This library is **AI-optimized**:
|
|
404
|
+
- Outputs structured data designed for LLM consumption
|
|
405
|
+
- Provides ranked selectors with stability scores
|
|
406
|
+
- Progressive extraction minimizes token usage
|
|
407
|
+
- Preserves semantic context (landmarks, forms, interactivity)
|
|
408
|
+
|
|
409
|
+
### Can I use this with Puppeteer/Playwright?
|
|
410
|
+
|
|
411
|
+
Yes! The library is stateless - pass any `document` object:
|
|
412
|
+
|
|
413
|
+
```typescript
|
|
414
|
+
const page = await browser.newPage();
|
|
415
|
+
await page.goto('https://example.com');
|
|
416
|
+
const result = await page.evaluate(() => {
|
|
417
|
+
return SmartDOMReader.extractInteractive(document);
|
|
418
|
+
});
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
### How do selector rankings work?
|
|
422
|
+
|
|
423
|
+
Selectors are ranked by stability (higher = more reliable):
|
|
424
|
+
1. **ID selectors** (score: 100) - `#unique-id`
|
|
425
|
+
2. **data-testid** (score: 90) - `[data-testid="submit"]`
|
|
426
|
+
3. **ARIA** (score: 80) - `[role="button"][aria-label="Submit"]`
|
|
427
|
+
4. **Name/ID attributes** (score: 70) - `input[name="email"]`
|
|
428
|
+
5. **Class paths** (score: 50) - `.form-container .submit-btn`
|
|
429
|
+
|
|
430
|
+
### Does it handle Shadow DOM?
|
|
431
|
+
|
|
432
|
+
Yes! Set `includeShadowDOM: true` to traverse shadow roots.
|
|
433
|
+
|
|
434
|
+
### What's the token overhead vs raw HTML?
|
|
435
|
+
|
|
436
|
+
Progressive extraction can reduce token usage by 80-95% compared to raw HTML, depending on the page and what you extract.
|
|
437
|
+
|
|
438
|
+
## Comparison with Alternatives
|
|
439
|
+
|
|
440
|
+
| Feature | @mcp-b/smart-dom-reader | Cheerio | jsdom | Raw DOM |
|
|
441
|
+
|---------|-------------------------|---------|-------|---------|
|
|
442
|
+
| AI-Optimized Output | Yes | No | No | No |
|
|
443
|
+
| Ranked Selectors | Yes | No | No | No |
|
|
444
|
+
| Token Efficiency | Progressive | N/A | N/A | N/A |
|
|
445
|
+
| Shadow DOM | Yes | No | Limited | Yes |
|
|
446
|
+
| Browser Environment | Native | Parse only | Simulated | Native |
|
|
447
|
+
| Zero Dependencies | Yes | No | No | Yes |
|
|
448
|
+
|
|
370
449
|
## Credits
|
|
371
450
|
|
|
372
451
|
Inspired by:
|
|
@@ -374,9 +453,28 @@ Inspired by:
|
|
|
374
453
|
- [dom-to-semantic-markdown](https://github.com/romansky/dom-to-semantic-markdown) - Content scoring algorithms
|
|
375
454
|
- [z-context](https://github.com/gwwar/z-context) - Selector generation approaches
|
|
376
455
|
|
|
456
|
+
## Related Packages
|
|
457
|
+
|
|
458
|
+
- [`@mcp-b/global`](https://docs.mcp-b.ai/packages/global) - W3C Web Model Context API polyfill
|
|
459
|
+
- [`@mcp-b/transports`](https://docs.mcp-b.ai/packages/transports) - Browser-specific MCP transports
|
|
460
|
+
- [`@mcp-b/chrome-devtools-mcp`](https://docs.mcp-b.ai/packages/chrome-devtools-mcp) - Connect desktop AI agents to browser
|
|
461
|
+
- [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk) - Official MCP SDK
|
|
462
|
+
|
|
463
|
+
## Resources
|
|
464
|
+
|
|
465
|
+
- [WebMCP Documentation](https://docs.mcp-b.ai)
|
|
466
|
+
- [Model Context Protocol Spec](https://modelcontextprotocol.io)
|
|
467
|
+
- [MCP GitHub Repository](https://github.com/modelcontextprotocol)
|
|
468
|
+
|
|
377
469
|
## License
|
|
378
470
|
|
|
379
|
-
MIT
|
|
471
|
+
MIT - see [LICENSE](../../LICENSE) for details
|
|
472
|
+
|
|
473
|
+
## Support
|
|
474
|
+
|
|
475
|
+
- [GitHub Issues](https://github.com/WebMCP-org/npm-packages/issues)
|
|
476
|
+
- [Documentation](https://docs.mcp-b.ai)
|
|
477
|
+
- [Discord Community](https://discord.gg/a9fBR6Bw)
|
|
380
478
|
|
|
381
479
|
## MCP Server (Golden Path)
|
|
382
480
|
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/markdown-formatter.ts","../src/bundle-types.ts","../src/content-detection.ts","../src/progressive.ts","../src/selectors.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/markdown-formatter.ts","../src/bundle-types.ts","../src/content-detection.ts","../src/progressive.ts","../src/selectors.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mcp-b/smart-dom-reader",
|
|
3
|
-
"version": "1.0.3-beta.
|
|
4
|
-
"description": "Token-efficient DOM extraction
|
|
3
|
+
"version": "1.0.3-beta.2",
|
|
4
|
+
"description": "Token-efficient DOM extraction for AI agents - Extract interactive elements, semantic structure, and stable CSS selectors for LLM-powered browser automation",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
7
7
|
"model-context-protocol",
|
|
@@ -11,16 +11,34 @@
|
|
|
11
11
|
"ai",
|
|
12
12
|
"selector",
|
|
13
13
|
"interactive",
|
|
14
|
-
"semantic"
|
|
14
|
+
"semantic",
|
|
15
|
+
"llm",
|
|
16
|
+
"claude",
|
|
17
|
+
"chatgpt",
|
|
18
|
+
"openai",
|
|
19
|
+
"anthropic",
|
|
20
|
+
"web-scraping",
|
|
21
|
+
"css-selector",
|
|
22
|
+
"xpath",
|
|
23
|
+
"browser-automation",
|
|
24
|
+
"puppeteer",
|
|
25
|
+
"playwright",
|
|
26
|
+
"ai-agents",
|
|
27
|
+
"token-efficient",
|
|
28
|
+
"dom-parser",
|
|
29
|
+
"web-ai",
|
|
30
|
+
"userscript",
|
|
31
|
+
"shadow-dom",
|
|
32
|
+
"iframe"
|
|
15
33
|
],
|
|
16
|
-
"homepage": "https://
|
|
34
|
+
"homepage": "https://docs.mcp-b.ai/packages/smart-dom-reader",
|
|
17
35
|
"bugs": {
|
|
18
|
-
"url": "https://github.com/
|
|
36
|
+
"url": "https://github.com/WebMCP-org/npm-packages/issues"
|
|
19
37
|
},
|
|
20
38
|
"repository": {
|
|
21
39
|
"type": "git",
|
|
22
|
-
"url": "git+https://github.com/
|
|
23
|
-
"directory": "
|
|
40
|
+
"url": "git+https://github.com/WebMCP-org/npm-packages.git",
|
|
41
|
+
"directory": "smart-dom-reader"
|
|
24
42
|
},
|
|
25
43
|
"license": "MIT",
|
|
26
44
|
"author": "Alex Nahas",
|
|
@@ -28,12 +46,12 @@
|
|
|
28
46
|
"type": "module",
|
|
29
47
|
"exports": {
|
|
30
48
|
".": {
|
|
31
|
-
"
|
|
32
|
-
"
|
|
49
|
+
"types": "./dist/index.d.ts",
|
|
50
|
+
"import": "./dist/index.js"
|
|
33
51
|
},
|
|
34
52
|
"./bundle-string": {
|
|
35
|
-
"
|
|
36
|
-
"
|
|
53
|
+
"types": "./dist/bundle-string.d.ts",
|
|
54
|
+
"import": "./dist/bundle-string.js"
|
|
37
55
|
}
|
|
38
56
|
},
|
|
39
57
|
"main": "./dist/index.js",
|