{"_id":"google-news-scraper-mcp","_rev":"5-4613f258808637815598f7e2ae8254e9","name":"google-news-scraper-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.0.0-stage":{"name":"google-news-scraper-mcp","version":"0.0.0-stage","_id":"google-news-scraper-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"}],"dist":{"shasum":"f020012bcc7cb645bf567c63c267da1c7a40ffda","tarball":"https://registry.npmjs.org/google-news-scraper-mcp/-/google-news-scraper-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-9pdZei4qo3qRyrpMXzTGcjknOokc08DmdygH8R2Xslb/YgUHfoey9aWUxIZsbfWvT2XNfRO9iZiSU0beDkWp5w==","signatures":[{"sig":"MEYCIQCk4wUt5QYh3hLQTTvhf3BYcb1erRiP6HoOivARC2/omQIhAMCuY4HlV/9bNndOyEbAeRoR5u1+QlU/WL8812cCM62S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":345},"_npmUser":{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"google-news-scraper-mcp","version":"0.1.0","keywords":["mcp","mcp-server","model context protocol","google news","news","news api","ai agents","claude","cursor","llm"],"author":{"name":"Lewis Donovan"},"license":"MIT","_id":"google-news-scraper-mcp@0.1.0","maintainers":[{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"}],"homepage":"https://github.com/lewisdonovan/google-news-scraper/tree/master/mcp#readme","bugs":{"url":"https://github.com/lewisdonovan/google-news-scraper/issues"},"bin":{"google-news-scraper-mcp":"src/index.js"},"dist":{"shasum":"1d5393b666204d5b15f09cdebe073953943bb973","tarball":"https://registry.npmjs.org/google-news-scraper-mcp/-/google-news-scraper-mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-fNlpkEDiN4ZnXfmgoM7JOYulxnn6tGjQgzhaBsLXSEMg+AOnPN6abo6Jl5bM8Tj8puiS6gAaEqh79tRxx//Blg==","signatures":[{"sig":"MEUCIQCsUa8EKUMXzdJC6tC6TNy9ZvpNc8TWjCMYSCDkvoQalwIgPvaJNwavYnzh66kVXBcJd39S3qeaGhvCEtQtgFPGiEg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCxL6Jc0YQLFYgxRsoDTDkruY5AyV8AWwUU9pdj6Ime3gIhANzZ/2krGU38Yb9hWY9uFlDnnOn8uu5LeREXDIu6EYw6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10757},"main":"src/index.js","type":"module","engines":{"node":">=20.19"},"gitHead":"42cb54067691c02cd8c90e5f36b60cd572b5cefd","mcpName":"io.github.lewisdonovan/google-news","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"},"repository":{"url":"git+https://github.com/lewisdonovan/google-news-scraper.git","type":"git","directory":"mcp"},"_npmVersion":"11.19.0","description":"MCP server for Google News: search news, get top stories and read articles from any AI agent. No API key, no headless browser.","directories":{},"_nodeVersion":"26.8.1","dependencies":{"zod":"^4.6.7","jsdom":"^29.1.1","google-news-scraper":"^3.0.3","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/google-news-scraper-mcp_0.1.0_1792063625171_0.3958822951432086","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"google-news-scraper-mcp","version":"0.1.1","keywords":["mcp","mcp-server","model context protocol","google news","news","news api","ai agents","claude","cursor","llm"],"author":{"name":"Lewis Donovan"},"license":"MIT","_id":"google-news-scraper-mcp@0.1.1","maintainers":[{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"}],"homepage":"https://github.com/lewisdonovan/google-news-scraper/tree/master/mcp#readme","bugs":{"url":"https://github.com/lewisdonovan/google-news-scraper/issues"},"bin":{"google-news-scraper-mcp":"src/index.js"},"dist":{"shasum":"0d2f4ce9b5ecf964efd1f541f0aaf8874465ae4e","tarball":"https://registry.npmjs.org/google-news-scraper-mcp/-/google-news-scraper-mcp-0.1.1.tgz","fileCount":5,"integrity":"sha512-W+7AFRABJwrNxWmPooRRIjKSFUz2QPoR24myYLMS1YBJmluEP+NKvaD+ygLP5GelKRtk/jKRT4uKHI+76z0sVA==","signatures":[{"sig":"MEYCIQCa3HsnIDYv/LZYDy+bjY+r67iAKn17tF17NhaxHZyaGQIhAM8etZa8XRblP4nU8Q+wD9CdHp52P5yvjVhLaQs849e5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDyd/LiHdaMuYow0TjBGvL2jyI37fu/Teud7PGmKdV+8QIhAMfQ8ENB7P2KAp7XvqaVyhr/3xSluCP19EYhiB/ixKJ9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12059},"main":"src/index.js","type":"module","engines":{"node":">=20.19"},"gitHead":"782aa60ae07d9c2a02e7f2d2a77e89066da78c6a","mcpName":"io.github.lewisdonovan/google-news","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"},"repository":{"url":"git+https://github.com/lewisdonovan/google-news-scraper.git","type":"git","directory":"mcp"},"_npmVersion":"11.19.0","description":"MCP server for Google News: search news, get top stories and read articles from any AI agent. No API key, no headless browser.","directories":{},"_nodeVersion":"26.8.1","dependencies":{"zod":"^4.6.7","jsdom":"^29.1.1","google-news-scraper":"^3.0.3","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/google-news-scraper-mcp_0.1.1_1792065644512_0.25476473138078504","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"google-news-scraper-mcp","version":"0.1.2","keywords":["mcp","mcp-server","model context protocol","google news","news","news api","ai agents","claude","cursor","llm"],"author":{"name":"Lewis Donovan"},"license":"MIT","_id":"google-news-scraper-mcp@0.1.2","maintainers":[{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"}],"homepage":"https://github.com/lewisdonovan/google-news-scraper/tree/master/mcp#readme","bugs":{"url":"https://github.com/lewisdonovan/google-news-scraper/issues"},"bin":{"google-news-scraper-mcp":"src/index.js"},"dist":{"shasum":"85b780f7b8e2d3a1ee592c99b368662746b99a18","tarball":"https://registry.npmjs.org/google-news-scraper-mcp/-/google-news-scraper-mcp-0.1.2.tgz","fileCount":6,"integrity":"sha512-//vrl43Vx2FCEzNlHbIln+9jwKimit94B94STLxhZ+wc8L9W/UtH96Avq6IgnFMUFAW2OKsCV4U/YkOe2hTMgw==","signatures":[{"sig":"MEUCIHW0YbLSuJd0TyYWwUvQDVBLpNBgNSeP/NX0YrP/oiwLAiEAn9EpchtsBC5McNVIBIyedfREL/SY/7qbHOR8zYOouGw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCRnOmEdZR0BYTJdZP8mm13MAN+4X5tF+lEJEtIBGt5LAIhAM6I0lqTiX9HTyumQzZfLrGXLjkrmd591nCzLurZkXZ0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97022},"main":"src/index.js","type":"module","engines":{"node":">=20.19"},"gitHead":"7818f1c944a450390364ee685edbfd5f2195c831","mcpName":"io.github.lewisdonovan/google-news","scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"},"repository":{"url":"git+https://github.com/lewisdonovan/google-news-scraper.git","type":"git","directory":"mcp"},"_npmVersion":"11.19.0","description":"MCP server for Google News: search news, get top stories and read articles from any AI agent. No API key, no headless browser.","directories":{},"_nodeVersion":"26.8.1","dependencies":{"zod":"^4.6.7","jsdom":"^29.1.1","google-news-scraper":"^3.0.3","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":true,"_npmOperationalInternal":{"tmp":"tmp/google-news-scraper-mcp_0.1.2_1792065990213_0.9237801118002524","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"_id":"google-news-scraper-mcp@0.2.0","bin":{"google-news-scraper-mcp":"src/index.js"},"bugs":{"url":"https://github.com/lewisdonovan/google-news-scraper/issues"},"dist":{"shasum":"c993e08690f3e6e65cdf7839488481516759ebb3","tarball":"https://registry.npmjs.org/google-news-scraper-mcp/-/google-news-scraper-mcp-0.2.0.tgz","fileCount":6,"integrity":"sha512-Qv1so/aYbbbewa0DUI64FymfpNJLePaVpqRjPyjzD7TixuJ+tzXe8VWKMAvVCO8mWNMq6KZMDN8WKbXdZ1iQ1Q==","signatures":[{"sig":"MEUCICV+d0GIh3IPbbHShiWTC09QFe+x7oN9yXQPwP+y57+xAiEA5GPyoAFLXE9zzQf3s1khfmvJlIWA2BsNWNi3j4FLHKE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGODtKOvmWRr9THdIqnO5JLMM6hrsrZwt7d79dc2VNZvAiEA2iyoofQrNVeVyA7tXknvf9JVp/ryn+8aZn7WXxuZWSI="}],"unpackedSize":98836},"main":"src/index.js","name":"google-news-scraper-mcp","type":"module","author":{"name":"Lewis Donovan"},"engines":{"node":">=20.19"},"gitHead":"f4cdf853a8eed0f76005875a278dffa4d7a23a22","license":"MIT","mcpName":"io.github.lewisdonovan/google-news","scripts":{"test":"node --test test/*.test.mjs"},"version":"0.2.0","_npmUser":{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"},"homepage":"https://github.com/lewisdonovan/google-news-scraper/tree/master/mcp#readme","keywords":["mcp","mcp-server","model context protocol","google news","news","news api","ai agents","claude","cursor","llm"],"repository":{"url":"git+https://github.com/lewisdonovan/google-news-scraper.git","type":"git","directory":"mcp"},"_npmVersion":"11.19.0","description":"MCP server for Google News: search news, get top stories and read articles from any AI agent. No API key, no headless browser.","directories":{},"maintainers":[{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"}],"_nodeVersion":"26.8.1","dependencies":{"zod":"^4.6.7","jsdom":"^29.1.1","google-news-scraper":"^3.1.0","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":true,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-news-scraper-mcp_0.2.0_1793355995729_0.9009645350269508"}}},"time":{"created":"2026-10-15T11:26:08.086Z","modified":"2026-10-30T10:26:36.022Z","0.0.0-stage":"2026-10-15T11:26:08.086Z","0.1.0":"2026-10-15T11:27:05.298Z","0.1.1":"2026-10-15T12:00:44.603Z","0.1.2":"2026-10-15T12:06:30.310Z","0.2.0":"2026-10-30T10:26:35.850Z"},"bugs":{"url":"https://github.com/lewisdonovan/google-news-scraper/issues"},"author":{"name":"Lewis Donovan"},"license":"MIT","homepage":"https://github.com/lewisdonovan/google-news-scraper/tree/master/mcp#readme","keywords":["mcp","mcp-server","model context protocol","google news","news","news api","ai agents","claude","cursor","llm"],"repository":{"url":"git+https://github.com/lewisdonovan/google-news-scraper.git","type":"git","directory":"mcp"},"description":"MCP server for Google News: search news, get top stories and read articles from any AI agent. No API key, no headless browser.","maintainers":[{"name":"lewisdonovan","email":"hello@lewisdonovan.co.uk"}],"readme":"# 📰 Google News MCP\n\nGive any AI agent live news. This [Model Context Protocol](https://modelcontextprotocol.io) server lets Claude, Cursor, VS Code and other MCP clients search Google News, read the top stories in any country, and pull the text of an article.\n\nIt's built on [google-news-scraper](https://github.com/lewisdonovan/google-news-scraper), so there's no API key, no account and no headless browser. Results come with the real publisher URL rather than a Google redirect link.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `search_news` | Search for articles on any keyword, with a timeframe (`12h`, `7d`, `6m`), language and country. Supports Google operators such as quotes, `OR` and `site:`. |\n| `top_stories` | The current top stories for a country and language, or the stories on a Google News topic page. |\n| `get_article_text` | Fetch an article URL and return its readable body text, title, byline and publish time. |\n\nEach article comes back as `{ title, link, source, sourceUrl, datetime }`.\n\n## Setup\n\nYour MCP client starts the server itself, so there's nothing to keep running.\n\n### Claude Desktop\n\nDownload [google-news.mcpb](https://github.com/lewisdonovan/google-news-scraper/releases/download/mcp-v0.2.0/google-news.mcpb) and double-click it, or drag it into **Settings → Extensions**. Claude Desktop installs it with its own Node.js, so you don't need Node installed.\n\n### Claude Code\n\n```bash\n/plugin install google-news --marketplace lewisdonovan/google-news-scraper\n```\n\nOr add the server directly with `claude mcp add google-news -- npx -y google-news-scraper-mcp`.\n\n### Cursor, Windsurf and most other clients\n\nRequires Node.js 20.19 or later.\n\nAdd this to the client's MCP config (`.cursor/mcp.json`, `claude_desktop_config.json`, and so on):\n\n```json\n{\n  \"mcpServers\": {\n    \"google-news\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"google-news-scraper-mcp\"]\n    }\n  }\n}\n```\n\n### VS Code\n\n```bash\ncode --add-mcp '{\"name\":\"google-news\",\"command\":\"npx\",\"args\":[\"-y\",\"google-news-scraper-mcp\"]}'\n```\n\n## Optional: a fallback when Google blocks you\n\nGoogle rate-limits busy IPs, which is common on cloud servers. If you have a [SerpApi](https://serpapi.com/google-news-api) key, the server can fetch results through SerpApi's Google News API instead. Set these environment variables in your client's MCP config:\n\n| Variable | What it does |\n| --- | --- |\n| `GOOGLE_NEWS_THIRD_PARTY_APIKEY` | Your SerpApi API key. Without it, only the free scraper is used. |\n| `GOOGLE_NEWS_THIRD_PARTY_PRIMARY` | `true` (default) calls SerpApi first and scrapes only if it fails. `false` scrapes first and calls SerpApi only if Google can't be reached. |\n\n```json\n{\n  \"mcpServers\": {\n    \"google-news\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"google-news-scraper-mcp\"],\n      \"env\": { \"GOOGLE_NEWS_THIRD_PARTY_APIKEY\": \"your-key\", \"GOOGLE_NEWS_THIRD_PARTY_PRIMARY\": \"false\" }\n    }\n  }\n}\n```\n\nIn Claude Desktop, enter the key in the extension's settings instead. Each SerpApi call uses one of your SerpApi searches.\n\n## Example prompts\n\n* \"What's the latest news on Nvidia from the past day?\"\n* \"Summarise today's top stories in Germany, in English.\"\n* \"Find coverage of our product launch on techcrunch.com this month and read the most recent article.\"\n\n## Notes\n\n* Google rate-limits bursts of requests from one IP. The scraper retries with backoff, but very heavy use can still get temporarily blocked. A [third-party key](#optional-a-fallback-when-google-blocks-you) keeps results coming.\n* `get_article_text` reads the page's HTML directly, so paywalled pages and sites that only render with JavaScript may return an error.\n\n## Privacy\n\nThe server collects and stores nothing. It sends your queries to Google News, or to SerpApi if you set a key, and fetches the article pages you ask it to read. See the [privacy policy](PRIVACY.md).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}