copyseeker-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CopySeeker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# 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://i.pcmag.com/imagery/reviews/04R1s9xuQfmVH4MHFeuaghc-10..v1570064456.jpg
+```
+
+### 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
+
+CopySeeker offers flexible pricing through RapidAPI:
+
+- **Free Tier**: 100 searches/month
+- **Basic**: $9.99/month - 1,000 searches
+- **Pro**: $29.99/month - 5,000 searches
+- **Enterprise**: Custom pricing for high-volume usage
+
+[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
+
+- 📧 Email: support@copyseeker.net
+- 🌐 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**

package/package.json

@@ -0,0 +1,55 @@
+{
+    "name": "copyseeker-mcp-server",
+    "version": "1.0.0",
+    "description": "MCP server for CopySeeker reverse image search API - find similar images and sources",
+    "main": "build/index.js",
+    "bin": {
+      "copyseeker-mcp": "build/index.js"
+    },
+    "type": "module",
+    "scripts": {
+      "build": "tsc",
+      "start": "node build/index.js",
+      "dev": "tsx src/index.ts",
+      "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+      "@modelcontextprotocol/sdk": "^0.4.0",
+      "axios": "^1.6.0"
+    },
+    "devDependencies": {
+      "@types/node": "^20.0.0",
+      "typescript": "^5.0.0",
+      "tsx": "^4.0.0"
+    },
+    "keywords": [
+      "mcp",
+      "model-context-protocol",
+      "reverse-image-search",
+      "copyseeker",
+      "claude",
+      "image-search",
+      "similar-images",
+      "reverse-search",
+      "copyright-check",
+      "image-analysis"
+    ],
+    "author": "CopySeeker <support@copyseeker.net>",
+    "license": "MIT",
+    "homepage": "https://copyseeker.net",
+    "repository": {
+      "type": "git",
+      "url": "https://github.com/copyseeker/copyseeker-mcp-server.git"
+    },
+    "bugs": {
+      "url": "https://github.com/copyseeker/copyseeker-mcp-server/issues"
+    },
+    "engines": {
+      "node": ">=18.0.0"
+    },
+    "files": [
+      "build/**/*",
+      "README.md",
+      "LICENSE"
+    ]
+  }