# Litescrape

Gives your agent Google, Bing, DuckDuckGo and Google Maps results as structured JSON. Handy when you need fresh web data and have no key or account.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: litescrape
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/litescrape/litescrape-mcp-server
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/litescrape

## What it does

The server pulls results from each site's own pages and hands them back as JSON. Links point at real destinations rather than redirects, and nothing is cached, so every call goes out fresh. Four tools work with no key: `google_search`, `bing_search`, `duckduckgo_search` and `google_maps`. On `google_search` you can set `fast_mode` to get organic results only, which is quicker.

Free calls are capped per network per UTC day: 25 for `google_search`, 50 for each of the other three. Only one call per network runs at a time, and failed calls do not count against the cap. Once you hit the cap, the tool result reports it and spells out for the model how to add a key, so the agent can pass that on to you. Setting `LITESCRAPE_API_KEY` lifts the daily caps, allows concurrent calls and opens the rest of the catalog — `google_ai_mode`, `google_ai_overview`, `google_shopping`, `google_reviews`, `web_fetch` and more. Those are reachable through `find_tools` and `call_tool`.

Running it locally needs Node.js 20 or newer. If you would rather install nothing, point your client at `https://mcp.litescrape.com/mcp` — same tools, same free allowance, with the key sent as `Authorization: Bearer ls_live_...`. The tool list stays small either way, around 5K tokens, whether or not a key is present.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.litescrape.com/mcp`
- Environment variables: `LITESCRAPE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http litescrape-mcp-server https://mcp.litescrape.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env LITESCRAPE_API_KEY=<LITESCRAPE_API_KEY> --transport stdio litescrape -- npx -y litescrape-mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add litescrape --url https://mcp.litescrape.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add litescrape --env LITESCRAPE_API_KEY=<LITESCRAPE_API_KEY> -- npx -y litescrape-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "litescrape": {
            "url": "https://mcp.litescrape.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "litescrape": {
            "command": "npx",
            "args": [
                "-y",
                "litescrape-mcp-server"
            ],
            "env": {
                "LITESCRAPE_API_KEY": "<LITESCRAPE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "litescrape": {
            "type": "http",
            "url": "https://mcp.litescrape.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "litescrape": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "litescrape-mcp-server"
            ],
            "env": {
                "LITESCRAPE_API_KEY": "<LITESCRAPE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http litescrape https://mcp.litescrape.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e LITESCRAPE_API_KEY=<LITESCRAPE_API_KEY> litescrape npx -y litescrape-mcp-server
```
Replace <…> with your own values

## When to use it
- pull Google results as structured data with no key
- look up places, addresses and ratings via Google Maps
- compare Bing and DuckDuckGo output for one query
- feed fresh web data into an agent's context
- see which tools a key would open before buying one

## Example prompts
- Use `google_search` to find recent posts about MCP servers and list the links
- Show me addresses and ratings for coffee shops near the office with `google_maps`
- What does `find_tools` offer for the task "scrape a product page"?

## Similar
- [SerpApi](https://affpapa.org/en/nevibecode/mcp/serpapi.md) — MCP server · ★ 182
- [pinkpixel-dev-web-scout-mcp](https://affpapa.org/en/nevibecode/mcp/pinkpixel-dev-web-scout-mcp.md) — MCP server · ★ 141
- [tracking-google-serp-rankings](https://affpapa.org/en/nevibecode/skills/tracking-google-serp-rankings.md) — skill · 763 installs
- [search](https://affpapa.org/en/nevibecode/skills/brightdata-search.md) — skill · 7500 installs
- [tavily-search](https://affpapa.org/en/nevibecode/skills/framix-team-tavily-search.md) — skill · 840 installs
- [tavily](https://affpapa.org/en/nevibecode/skills/tavily.md) — skill · 627 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md