fiverr-mcp-server

Fiverr 的非官方 MCP 服务

名称提示： Fiverr International Ltd. 已通过 GitHub 要求本项目明确说明其并非 Fiverr 官方产品。特此说明：这是一个非官方、独立、由社区打造的开源项目，与 Fiverr International Ltd. 无关联，也未获其认可或赞助。FIVERR 是 Fiverr International Ltd. 的注册商标。本仓库已从 fiverr-mcp-server 更名；PyPI 软件包也可能更名，任何新名称都会在此处链接。

mcp-name: io.github.KyuRish/fiverr-mcp-server

用于搜索和浏览 Fiverr 的 MCP 服务，可查看服务项目、卖家、价格和评价。无需 API 密钥。

功能

• 按关键词搜索服务项目，并支持筛选（价格、卖家级别、类别、排序）
• 获取服务项目详情，包括定价套餐（Basic/Standard/Premium）、描述和标签
• 查看卖家资料，包括认证、语言、时薪和服务项目列表
• 查看服务项目评价，获取任意服务项目的第一页评价
• 列出类别，以便查找筛选搜索所需的有效类别标识
• 所有价格均以 USD 返回（不是美分）
• 内置速率限制，并在重试时轮换浏览器指纹
• 失败时返回结构化的错误消息（不会直接崩溃）

安装

使用 uvx（推荐）

{
  "mcpServers": {
    "fiverr": {
      "command": "uvx",
      "args": ["fiverr-mcp-server"]
    }
  }
}

使用 pip

pip install fiverr-mcp-server

从源代码安装

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

配置

添加到 Claude Desktop 配置文件（claude_desktop_config.json）：

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fiverr": {
      "command": "uvx",
      "args": ["fiverr-mcp-server"]
    }
  }
}

环境变量

变量	描述	默认值
TRANSPORT	传输模式（stdio 或 sse）	stdio
PROXY_URL	可选的请求 HTTP 代理	-
RATE_LIMIT_DELAY	请求之间的最短间隔秒数	2

可用工具

search_gigs

按关键词搜索 Fiverr 市场。每页最多返回 48 个服务项目，并附带分页信息。

参数：

• query（必需）- 搜索词（例如“logo design”“python developer”）
• category - 类别标识（使用 list_categories 查看有效值）
• min_price / max_price - 以 USD 为单位的价格范围筛选
• seller_level - "level_one_seller"、"level_two_seller" 或 "top_rated_seller"
• sort_by - "relevance"、"best_selling"、"newest"、"price_asc" 或 "price_desc"
• page - 分页页码

返回： 服务项目列表，包含标题、价格（USD）、评分、评价数量、卖家名称和 URL。还包含用于分页的 total_results 和 has_more。

get_gig_details

获取指定服务项目的完整详情，包括所有定价等级。

参数：

• url（必需）- Fiverr 服务项目 URL 或路径

返回： 标题、描述、卖家信息、套餐（名称/价格/交付时间/修改次数/功能）、标签、元数据、评分、评价数量、类别和排队订单数。

get_seller_profile

获取卖家资料。使用搜索结果中的 seller_name 作为用户名。

参数：

• username（必需）- 卖家的 Fiverr 用户名

返回： 显示名称、简介、所在地、加入时间、语言、认证、时薪（USD）、服务项目列表和验证状态。

get_gig_reviews

获取某个服务项目第一页的评价（通常会从页面加载 5-10 条评价）。

参数：

• url（必需）- Fiverr 服务项目 URL 或路径

返回： 评价列表，包含买家名称、国家、评分、日期和文本。

list_categories

列出可与 search_gigs 搭配使用的所有 Fiverr 类别标识。

返回： 类别对象列表，包含 slug 和 name。

工作流示例

寻找自由职业者：

1. list_categories() - 查看可用类别
2. search_gigs("3D character modeling") - 浏览搜索结果
3. get_gig_details(url) - 查看定价档位（使用搜索结果中的 URL）
4. get_seller_profile(seller_name) - 查看卖家资料（使用搜索结果中的 seller_name）
5. get_gig_reviews(url) - 阅读评价

限制

• 评价 - 只能获取评价的第一页（Fiverr 通过 AJAX 加载更多内容，需要经过身份验证的请求）
• 速率限制 - Fiverr 可能会拦截快速连续的请求。请求之间强制至少间隔 2 秒（可通过 RATE_LIMIT_DELAY 配置）
• 数据时效性 - 所有数据均实时抓取自公开页面，不会缓存

工作原理

此服务通过读取 Fiverr 前端框架嵌入每个页面的 Perseus SSR 数据块（<script id="perseus-initial-props">），从 Fiverr 的公开页面中提取结构化数据。使用 curl_cffi 模拟浏览器 TLS 指纹以应对 Cloudflare 防护，并支持自动重试和指纹轮换。

负责任地使用

此工具供个人使用，通过 AI 助手寻找自由职业者、比较服务项目和阅读评价。请：

• 不要用于大规模收集数据或构建卖家信息数据库
• 不要用于大规模自动化竞品监控
• 请保留默认速率限制，以减轻 Fiverr 基础设施的负担
• 请注意，网页抓取可能违反 Fiverr 的服务条款

开发

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

许可证

MIT