mcp-server-for-fiverr-unofficial

# Unofficial MCP Server for Fiverr > **Heads-up on naming:** Fiverr International Ltd. has asked, through GitHub, that this project make clear it is not an official Fiverr product. To be clear: this is an unofficial, independent, community-built open-source project. It is not affiliated with, endorsed by, or sponsored by Fiverr International Ltd. FIVERR is a registered trademark of Fiverr International Ltd. This repository was renamed from `fiverr-mcp-server`; the PyPI package may be renamed too, and any new name will be linked here. [](https://pypi.org/project/fiverr-mcp-server/) [](https://opensource.org/licenses/MIT) mcp-name: io.github.KyuRish/fiverr-mcp-server MCP server for searching and browsing Fiverr - gigs, sellers, pricing, and reviews. No API key required. ## Features - **Search gigs** by keyword with filters (price, seller level, category, sorting) - **Get gig details** including pricing packages (Basic/Standard/Premium), description, and tags - **View seller profiles** with certifications, languages, hourly rate, and gig listings - **Read gig reviews** from the first page of any gig - **List categories** to discover valid category slugs for filtered search - All prices returned in **USD** (not cents) - Built-in **rate limiting** and retry with browser fingerprint rotation - Structured **error messages** on failures (no raw crashes) ## Installation ### Using uvx (recommended) ```json { "mcpServers": { "fiverr": { "command": "uvx", "args": ["fiverr-mcp-server"] } } } ``` ### Using pip ```bash pip install fiverr-mcp-server ``` ### From source ```bash git clone https://github.com/KyuRish/mcp-server-for-fiverr-unofficial.git cd mcp-server-for-fiverr-unofficial uv sync uv run fiverr-mcp-server ``` ## Configuration Add to your Claude Desktop config (`claude_desktop_config.json`): - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "fiverr": { "command": "uvx", "args": ["fiverr-mcp-server"] } } } ``` ### Environment Variables | Variable | Description | Default | |----------|-------------|---------| | `TRANSPORT` | Transport mode (`stdio` or `sse`) | `stdio` | | `PROXY_URL` | Optional HTTP proxy for requests | - | | `RATE_LIMIT_DELAY` | Minimum seconds between requests | `2` | ## Available Tools ### `search_gigs` Search the Fiverr marketplace by keyword. Returns up to 48 gigs per page with pagination info. **Parameters:** - `query` (required) - Search query (e.g. "logo design", "python developer") - `category` - Category slug (use `list_categories` to see valid values) - `min_price` / `max_price` - Price range filter in USD - `seller_level` - `"level_one_seller"`, `"level_two_seller"`, or `"top_rated_seller"` - `sort_by` - `"relevance"`, `"best_selling"`, `"newest"`, `"price_asc"`, or `"price_desc"` - `page` - Page number for pagination **Returns:** List of gigs with title, price (USD), rating, reviews count, seller name, and URL. Also includes `total_results` and `has_more` for pagination. ### `get_gig_details` Get full details of a specific gig including all pricing tiers. **Parameters:** - `url` (required) - Fiverr gig URL or path **Returns:** Title, description, seller info, packages (name/price/delivery/revisions/features), tags, metadata, rating, reviews count, category, and orders in queue. ### `get_seller_profile` Get a seller's profile. Use `seller_name` from search results as the username. **Parameters:** - `username` (required) - Seller's Fiverr username **Returns:** Display name, bio, location, member since, languages, certifications, hourly rate (USD), gig listings, and verification status. ### `get_gig_reviews` Get the first page of reviews for a gig (typically 5-10 reviews loaded from the page). **Parameters:** - `url` (required) - Fiverr gig URL or path **Returns:** List of reviews with buyer name, country, rating, date, and text. ### `list_categories` List all available Fiverr category slugs for use with `search_gigs`. **Returns:** List of category objects with `slug` and `name`. ## Workflow Examples **Finding a freelancer:** 1. `list_categories()` - see available categories 2. `search_gigs("3D character modeling")` - browse results 3. `get_gig_details(url)` - check pricing tiers (use URL from search results) 4. `get_seller_profile(seller_name)` - review their profile (use seller_name from search results) 5. `get_gig_reviews(url)` - read reviews ## Limitations - **Reviews** - only the first page of reviews is available (Fiverr loads more via AJAX which requires authenticated requests) - **Rate limiting** - Fiverr may block rapid requests. A 2-second minimum delay is enforced between requests (configurable via `RATE_LIMIT_DELAY`) - **Data freshness** - all data is scraped from public pages in real-time, not cached ## How It Works This server extracts structured data from Fiverr's public pages by reading the Perseus SSR data blob (`<script id="perseus-initial-props">`) that Fiverr's frontend framework embeds in every page. Uses `curl_cffi` for browser TLS fingerprint impersonation to handle Cloudflare protection, with automatic retry and fingerprint rotation. ## Responsible Use This tool is intended for personal use - finding freelancers, comparing gigs, and reading reviews through an AI assistant. Please: - Do not use for mass data harvesting or building databases of seller information - Do not use for automated competitive monitoring at scale - Respect Fiverr's infrastructure by keeping the default rate limit - Be aware that web scraping may violate Fiverr's Terms of Service ## Development ```bash git clone https://github.com/KyuRish/mcp-server-for-fiverr-unofficial.git cd mcp-server-for-fiverr-unofficial uv sync uv run fiverr-mcp-server ``` ## License MIT