README - Meerkats.ai MCP Server by meerkats-ai

Meerkats.ai MCP Server

This is a Model Context Protocol (MCP) server for the Meerkats.ai web scraping service. It provides tools for web scraping, RSS feed processing, and Google search.

Features

Web Scraping: Scrape any URL and get the content as markdown
RSS Feed Processing: Process RSS feeds and get the content
Google Search: Search Google and get the results

Installation

Clone this repository
Install dependencies:
```
npm install
```
Create a .env file based on .env.example and add your Meerkats.ai API key
Build the project:
```
npm run build
```

Configuration

Add the MCP server to your MCP settings configuration file:

{
  "mcpServers": {
    "meerkats": {
      "command": "node",
      "args": ["path/to/meerkats.ai/build/index.js"],
      "env": {
        "MEERKATS_API_KEY": "your_api_key_here",
        "SCRAPPER_API_URL": "https://api.meerkats.ai",
        "SCRAPPER_CALLBACK_API_URL": "https://api.meerkats.ai/callback"
      }
    }
  }
}

Available Tools

scrape_url

Scrape a URL and return the content as markdown.

Parameters:

url (required): URL to scrape
wait (optional): Time to wait in seconds before scraping
query (optional): Query to search for on the page

rss_feed

Process an RSS feed and return the content.

Parameters:

url (required): URL of the RSS feed
wait (optional): Time to wait in seconds before processing

google_search

Search Google and return the results.

Parameters:

query (required): Query to search for on Google

Example Usage

// Example of using the scrape_url tool
const result = await use_mcp_tool({
  server_name: "meerkats",
  tool_name: "scrape_url",
  arguments: {
    url: "https://example.com",
    wait: 2
  }
});

// Example of using the google_search tool
const searchResult = await use_mcp_tool({
  server_name: "meerkats",
  tool_name: "google_search",
  arguments: {
    query: "meerkats.ai web scraping"
  }
});