copyseeker-mcp-server/README.md

MCP server for CopySeeker reverse image search API - find similar images and sources

# Copyseeker MCP Server

A Model Context Protocol (MCP) server that integrates Copyseeker's powerful reverse image search API with Claude and other MCP-compatible AI assistants.

## Features

- 🔍 **Reverse Image Search**: Find similar images and their sources across the web
- 🖼️ **Multiple Input Methods**: Search by URL or upload images directly
- 📊 **Detailed Results**: Get comprehensive metadata about found images
- ⚡ **Fast & Reliable**: Powered by Copyseeker's robust API infrastructure
- 🔒 **Secure**: Your API key stays local, never shared

## Quick Start

### 1. Install the MCP Server

```bash
npm install -g copyseeker-mcp-server
```

### 2. Get Your API Key

1. Visit [RapidAPI Copyseeker](https://rapidapi.com/copyseeker1-copyseeker-default/api/reverse-image-search-by-copyseeker/)
2. Subscribe to a plan (free tier available)
3. Copy your RapidAPI key

### 3. Configure Claude Desktop

Add this to your Claude Desktop configuration file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "copyseeker": {
      "command": "copyseeker-mcp",
      "env": {
        "COPYSEEKER_RAPIDAPI_KEY": "your_rapidapi_key_here"
      }
    }
  }
}
```

### 4. Restart Claude Desktop

The Copyseeker tools will now be available in Claude!

## Usage Examples

### Complete Reverse Image Search
```
Can you do a complete reverse search on: https://copyseeker.net/assets/img/pc.png
```

### Copyright & Source Verification
```
I need to check if I can legally use this image. Please analyze: [image URL]
```

### Find Exact Matches
```
Where exactly does this image appear online? [image URL]
```

### Find Design Inspiration
```
Show me images that look similar to this design for inspiration: [image URL]
```

### Page Authority Assessment
```
Which website is the most credible source for this image? [image URL]
```

## Available Tools

### `reverse_image_search`
Complete reverse image search with all results formatted clearly.

**Parameters:**
- `image_url` (required): Direct URL to the image

**Returns:**
- AI analysis of what the image represents
- Exact matches (websites containing the same image)
- Visually similar images (different images that look alike)
- Page authority scores for credibility assessment
- AI-detected categories with confidence scores

### `analyze_image_copyright`
Specialized copyright and usage rights analysis.

**Parameters:**
- `image_url` (required): URL of the image to analyze

**Returns:**
- Copyright risk assessment based on where image appears
- Source credibility ranking by page authority
- Usage recommendations and next steps
- Likely original source identification

### `find_exact_matches`
Find websites containing the exact same image.

**Parameters:**
- `image_url` (required): URL of the image to find matches for

**Returns:**
- List of websites with the exact same image
- Page authority scores (higher = more credible source)
- Direct URLs to image files on each site
- Summary of distribution patterns

### `find_similar_images`
Discover visually similar images for inspiration and alternatives.

**Parameters:**
- `image_url` (required): URL of the image to find similarities for

**Returns:**
- URLs to different images that look visually similar
- Common visual elements and themes
- Use cases for similar images
- Style and category analysis

## Pricing

[View all pricing plans →](https://rapidapi.com/copyseeker1-copyseeker-default/api/reverse-image-search-by-copyseeker/pricing)

## Troubleshooting

### "API key required" error
Make sure you've set the `COPYSEEKER_RAPIDAPI_KEY` environment variable in your Claude configuration.

### "Rate limit exceeded"
Check your usage on the [RapidAPI dashboard](https://rapidapi.com/developer/dashboard) and consider upgrading your plan.

### "Image not found" error
Ensure the image URL is directly accessible and points to a valid image file (not a webpage containing an image).

## Support

- 🌐 Website: [copyseeker.net](https://copyseeker.net)
- 📚 API Documentation: [RapidAPI Docs](https://rapidapi.com/copyseeker1-copyseeker-default/api/reverse-image-search-by-copyseeker/)

## License

MIT License - see LICENSE file for details.

## Contributing

We welcome contributions! Please see our contributing guidelines and submit pull requests to our GitHub repository.

---

**Made with ❤️ by the Copyseeker team**