{"_id":"@claudemind/mcp-webresearch","_rev":"2-2fda79ce2eb1c323f50f0b5ef6270fe1","name":"@claudemind/mcp-webresearch","dist-tags":{"latest":"0.1.9"},"versions":{"0.1.8":{"name":"@claudemind/mcp-webresearch","version":"0.1.8","keywords":["mcp","model-context-protocol","web-research","ai","web-scraping"],"author":{"name":"Hawstein"},"license":"MIT","_id":"@claudemind/mcp-webresearch@0.1.8","maintainers":[{"name":"hawstein","email":"tomhawstein@gmail.com"}],"homepage":"https://github.com/Hawstein/mcp-webresearch","bugs":{"url":"https://github.com/Hawstein/mcp-webresearch/issues"},"bin":{"mcp-server-webresearch":"dist/index.js"},"dist":{"shasum":"4a1266d578d56485a20a3248b00ada9d661f3f84","tarball":"https://registry.npmjs.org/@claudemind/mcp-webresearch/-/mcp-webresearch-0.1.8.tgz","fileCount":6,"integrity":"sha512-YrDe5+prWMMVq4eFvxznNMtB9mvBWE99gizmC83GkAfnZr+jjN0HMH0amltTdHiNY/6LlSnPxkuuUSrWZvTtJQ==","signatures":[{"sig":"MEYCIQD1RLbIZ2G3hSoMZGcKtyF/ftveoN+Na+969UBKaTBrNwIhAJC8qaqURGUHt4un6nKrCMyljk4pzN/GiuuM/A9NGlRp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":85156},"type":"module","gitHead":"eeabce95a041a23a7cda3358d2c63572f9f071ad","scripts":{"dev":"tsx watch index.ts","build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"pnpm run build","postinstall":"playwright install chromium"},"_npmUser":{"name":"hawstein","email":"tomhawstein@gmail.com"},"_npmVersion":"11.0.0","description":"MCP server for web research","directories":{},"_nodeVersion":"22.12.0","dependencies":{"turndown":"^7.1.2","playwright":"^1.49.0","@modelcontextprotocol/sdk":"1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","tsx":"^4.19.2","typescript":"^5.6.2","@types/node":"^22.13.4","@types/turndown":"^5.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-webresearch_0.1.8_1740112471654_0.8792764844210825","host":"s3://npm-registry-packages-npm-production"}},"0.1.9":{"name":"@claudemind/mcp-webresearch","version":"0.1.9","description":"MCP server for web research","license":"MIT","author":{"name":"Hawstein"},"homepage":"https://github.com/Hawstein/mcp-webresearch","bugs":{"url":"https://github.com/Hawstein/mcp-webresearch/issues"},"type":"module","bin":{"mcp-server-webresearch":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"pnpm run build","postinstall":"playwright install chromium","watch":"tsc --watch","dev":"tsx watch index.ts"},"publishConfig":{"access":"public"},"keywords":["mcp","model-context-protocol","web-research","ai","web-scraping"],"dependencies":{"@modelcontextprotocol/sdk":"1.0.1","playwright":"^1.49.0","turndown":"^7.1.2"},"devDependencies":{"shx":"^0.3.4","tsx":"^4.19.2","typescript":"^5.6.2","@types/node":"^22.13.4","@types/turndown":"^5.0.4"},"_id":"@claudemind/mcp-webresearch@0.1.9","gitHead":"33c30f076afa5e1faac804dc02465c9666122d6a","_nodeVersion":"22.12.0","_npmVersion":"11.0.0","dist":{"integrity":"sha512-nlAnqd5QpwnzWYvr3hLngWBczeSn9TOR2kXxQz6YgaPC8/USaHRrroWFwRMI9UzPVp3MtkuSBnGl4N0dtNv4gg==","shasum":"54c3fd1c01483226028461ae87451083d831911e","tarball":"https://registry.npmjs.org/@claudemind/mcp-webresearch/-/mcp-webresearch-0.1.9.tgz","fileCount":6,"unpackedSize":91896,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHfOhQyDb0PL3xcZ02aggDyg3raeIX1BFD0a/cgVwNqqAiEA8kJAOkqB0lfzG2acXjNXPjdKu2flQvk2RJPZpDU+1Mk="}]},"_npmUser":{"name":"hawstein","email":"tomhawstein@gmail.com"},"directories":{},"maintainers":[{"name":"hawstein","email":"tomhawstein@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-webresearch_0.1.9_1745736144152_0.6768787274458326"},"_hasShrinkwrap":false}},"time":{"created":"2025-02-21T04:34:31.554Z","modified":"2025-04-27T06:42:24.533Z","0.1.8":"2025-02-21T04:34:31.841Z","0.1.9":"2025-04-27T06:42:24.349Z"},"bugs":{"url":"https://github.com/Hawstein/mcp-webresearch/issues"},"author":{"name":"Hawstein"},"license":"MIT","homepage":"https://github.com/Hawstein/mcp-webresearch","keywords":["mcp","model-context-protocol","web-research","ai","web-scraping"],"description":"MCP server for web research","maintainers":[{"name":"hawstein","email":"tomhawstein@gmail.com"}],"readme":"# MCP Web Research Server\n\nA Model Context Protocol (MCP) server for web research. \n\nBring real-time info into Claude and easily research any topic.\n\n> This is a Fork of [mzxrai/mcp-webresearch](https://github.com/mzxrai/mcp-webresearch). All credit for this project belongs to [mzxrai](https://github.com/mzxrai).\n> I'm just a quick fixer of the project's bugs, and just want to make this awesome project work!\n\n## Features\n\n- Google search integration\n- Webpage content extraction\n- Research session tracking (list of visited pages, search queries, etc.)\n- Screenshot capture\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) >= 18 (includes `npm` and `npx`)\n- [Claude Desktop app](https://claude.ai/download)\n\n## Installation\n\nFirst, ensure you've downloaded and installed the [Claude Desktop app](https://claude.ai/download) and you have npm installed.\n\nNext, add this entry to your `claude_desktop_config.json` (on Mac, found at `~/Library/Application\\ Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"webresearch\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mzxrai/mcp-webresearch@latest\"]\n    }\n  }\n}\n```\n\nThis config allows Claude Desktop to automatically start the web research MCP server when needed.\n\n## Usage\n\nSimply start a chat with Claude and send a prompt that would benefit from web research. If you'd like a prebuilt prompt customized for deeper web research, you can use the `agentic-research` prompt that we provide through this package. Access that prompt in Claude Desktop by clicking the Paperclip icon in the chat input and then selecting `Choose an integration` → `webresearch` → `agentic-research`.\n\n<img src=\"https://i.ibb.co/N6Y3C0q/Screenshot-2024-12-05-at-11-01-27-PM.png\" alt=\"Example screenshot of web research\" width=\"400\"/>\n\n### Tools\n\n1. `search_google`\n   - Performs Google searches and extracts results\n   - Arguments: `{ query: string }`\n\n2. `visit_page`\n   - Visits a webpage and extracts its content\n   - Arguments: `{ url: string, takeScreenshot?: boolean }`\n\n3. `take_screenshot`\n   - Takes a screenshot of the current page\n   - No arguments required\n\n### Prompts\n\n#### `agentic-research`\nA guided research prompt that helps Claude conduct thorough web research. The prompt instructs Claude to:\n- Start with broad searches to understand the topic landscape\n- Prioritize high-quality, authoritative sources\n- Iteratively refine the research direction based on findings\n- Keep you informed and let you guide the research interactively\n- Always cite sources with URLs\n\n### Resources\n\nWe expose two things as MCP resources: (1) captured webpage screenshots, and (2) the research session.\n\n#### Screenshots\n\nWhen you take a screenshot, it's saved as an MCP resource. You can access captured screenshots in Claude Desktop via the Paperclip icon.\n\n#### Research Session\n\nThe server maintains a research session that includes:\n- Search queries\n- Visited pages\n- Extracted content\n- Screenshots\n- Timestamps\n\n### Suggestions\n\nFor the best results, if you choose not to use the `agentic-research` prompt when doing your research, it may be helpful to suggest high-quality sources for Claude to use when researching general topics. For example, you could prompt `news today from reuters or AP` instead of `news today`.\n\n## Problems\n\nThis is very much pre-alpha code. And it is also AIGC, so expect bugs.\n\nIf you run into issues, it may be helpful to check Claude Desktop's MCP logs:\n\n```bash\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n```\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Build the project\npnpm build\n\n# Watch for changes\npnpm watch\n\n# Run in development mode\npnpm dev\n```\n\n## Requirements\n\n- Node.js >= 18\n- Playwright (automatically installed as a dependency)\n\n## Verified Platforms\n\n- [x] macOS\n- [ ] Linux\n\n## License\n\nMIT\n\n## Author\n\n[mzxrai](https://github.com/mzxrai) ","readmeFilename":"README.md"}