Geekflare

Name: Geekflare
Author: geekflare

远程服务

docs.geekflare.com开发工具16 天前更新

代码仓库访问官网

关于 Geekflare

Geekflare 是面向 AI 助手的 MCP 服务，提供网页情报与网络检测工具。它支持网页抓取和搜索、截图、DNS 查询、站点状态检查及端口和 TLS 扫描。

主要功能

01抓取网页内容与元数据
02搜索网页、新闻和图片
03获取网站品牌信息
04截取网页并转换为 PDF
05查询 DNS、站点状态与重定向
06扫描开放端口和 TLS 配置

适用场景

01提取网页正文或结构化数据
02搜索并整理网络资料
03检查网站可用性和重定向
04查看域名 DNS、端口及 TLS 信息

MCP 相关

作为 MCP 服务，Geekflare 向 Claude、Cursor、Windsurf 等客户端提供网页情报和网络检测工具。连接时需配置 API 密钥。

#scrape #search #dns-lookup #screenshot #site-availability

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.geekflare.com/{API_KEY}/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http geekflare-api https://mcp.geekflare.com/{API_KEY}/mcp

Cursor.cursor/mcp.json{"mcpServers":{"geekflare-api":{"type":"http","url":"https://mcp.geekflare.com/{API_KEY}/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"geekflare-api":{"type":"http","url":"https://mcp.geekflare.com/{API_KEY}/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"geekflare-api":{"type":"http","url":"https://mcp.geekflare.com/{API_KEY}/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"geekflare-api":{"serverUrl":"https://mcp.geekflare.com/{API_KEY}/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@geekflare/mcp0.5.0stdio

ocigeekflarehq/geekflare-api-mcp:0.5.0stdio

工具

参数	类型	必填	说明
blockAds	boolean	否
device	enum	否	desktop \| mobile
fileOutput	boolean	否	返回下载 URL，而不是内联数据
format	array	否	输出格式（最多 3 种）。
proxyCountry	string	否	代理路由使用的国家/地区代码
renderJS	boolean	否	在提取内容前执行 JavaScript
stealth	boolean	否	绕过 CAPTCHA（速度较慢）
url	string	是	目标 URL

详细介绍

@geekflare/mcp

面向 Geekflare 的官方 MCP（Model Context Protocol）服务。将 Geekflare 的网络智能工具直接连接到 Claude、Cursor、Windsurf 和其他 AI 助手。

设置

获取 API Key

在 geekflare.com/api 注册，并从控制面板复制 API key。

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "geekflare": {
      "command": "npx",
      "args": ["-y", "@geekflare/mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Windsurf

添加到 MCP 设置中：

{
  "mcpServers": {
    "geekflare": {
      "command": "npx",
      "args": ["-y", "@geekflare/mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "geekflare": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY=your-api-key-here", "geekflare/mcp"]
    }
  }
}

可用工具

`webScrape`

抓取任意 URL 的完整页面内容。返回 HTML、Markdown、JSON 或针对大模型优化的文本，还可通过现成的提取模板、自定义 CSS/XPath 架构或 AI 提取获取结构化数据。 | 参数 | 类型 | 默认值 | 描述 | | ------------------ | --------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------- | --------------------------------------- | | url * | string | — | 目标 URL | | device | desktop | mobile | desktop | 要模拟的设备 | | format | array | ["markdown"] | 输出格式（最多 3 种）：html、markdown、json、markdown-llm、html-llm、text、text-llm | | proxyMode | boolean | "auto" | false | false 表示从不使用代理，auto 表示网站阻止请求时通过代理重试，true 表示始终使用代理 | | proxyCountry | string | — | 通过国家/地区 ISO 代码（例如 "us"）路由，代理启用时使用 | | renderJS | boolean | auto | 提取前执行 JavaScript。如果省略，将根据页面是否需要自动确定 | | fileOutput | boolean | false | 返回下载 URL，而不是内联内容 | | blockAds | boolean | true | 抓取时屏蔽广告 | | stealth | boolean | false | 绕过 CAPTCHA（速度较慢） | | waitTime | number | 0 | 页面加载后、捕获内容前等待的秒数 | | extractionMode | default | cssSchema | xpathSchema | template | default | 仅在 format 包含 json 时使用 | | template | product | contact | — | 当 extractionMode 为 template 时使用的现成提取模板 | | extractionSchema | object | — | 用于 cssSchema/xpathSchema 模式的自定义字段提取架构 | | aiPrompt | object | — | 对抓取的页面进行 AI 驱动的提取/分析。支持 prompt、schema、listing、summary、sentiment 和 keywords 模式。额外消耗 6 个积分 |

`metaScrape`

抓取元标签——标题、描述、Open Graph、Twitter 卡片等。

| 参数 | 类型 | 默认值 | 描述 | | -------------- | --------- | ---------- | ----------------------------------------------- | ----------------- | | url * | string | — | 目标 URL | | device | desktop | mobile | desktop | 要模拟的设备 | | format | json | markdown | json | 响应格式 | | proxyCountry | string | — | 国家 ISO 代码 | | renderJS | boolean | true | 是否执行 JavaScript | | fileOutput | boolean | false | 返回下载 URL，而非内联内容 | | blockAds | boolean | true | 抓取时屏蔽广告 |

`brand`

获取网站域名的结构化品牌信息，包括品牌标识、徽标、颜色、字体、社交媒体主页、链接、页面元数据和公司信息。

brand 工具支持两个级别的品牌情报：

standard — 返回网站提供的结构化品牌信息。
enriched — 在可用时，包含大模型合成的额外公司情报。

参数	类型	默认值	描述	---------------------------------------------------------------------------------------
`url` *	string	—	目标 URL
`refresh`	boolean	`false`	强制即时抓取并刷新缓存的品牌数据
`mode`	`standard`	`enriched`	`standard`	要返回的品牌数据深度。`enriched` 包含大模型合成的公司情报

示例

{
  "url": "https://example.com",
  "mode": "enriched"
}

若要绕过缓存数据并获取最新信息：

{
  "url": "https://example.com",
  "refresh": true,
  "mode": "enriched"
}

响应可能包含：

品牌名称、标语、描述和口号
徽标和网站图标
品牌颜色和配色方案
字体和排版
UI 组件样式和间距
社交媒体主页
重要的网站链接
页面元数据和 Open Graph 信息
公司信息（如所属行业、成立年份、员工规模、营收范围、公司类型和目标受众，若可获取）

丰富的公司信息取决于该域名公开可用的信息，因此可能会省略个别字段。

`screenshot`

截取任意网站的屏幕截图。支持整页截图、仅截取元素、Retina、深色模式、透明背景和便于 AI 识别的链接高亮。

| 参数 | ----------------------- | url * | device | type | proxyCountry | fullPage | selector | fallbackToFullPage | blockAds | hideCookie | skipCaptcha | addTimestamp | highlightLinks | pageHeight | viewportWidth | viewportHeight | captureBeyondViewport | delay | quality | scaleFactor | theme | removeBackground | disableAnimations | inline | 类型 | 默认值 | 描述 | | --------- | -------- | --------------------------------------------------------------- | ----------------- | ------------ | | string | — | 目标 URL | | desktop | mobile | desktop | 要模拟的设备 | | png | jpeg | webp | png | 图像格式 | | string | — | 国家 ISO 代码 | | boolean | false | 截取整页 | | string | — | 要截取元素的 CSS 选择器 | | boolean | false | 找不到 selector 时回退到整页截图 | | boolean | true | 拦截广告 | | boolean | true | 移除 Cookie 横幅 | | boolean | true | 绕过反机器人验证 | | boolean | false | 添加时间戳 | | boolean | false | 为链接和按钮绘制边框——便于 AI 视觉模型识别 | | number | — | 自定义页面高度，单位为像素 | | number | — | 视口宽度 | | number | — | 视口高度 | | boolean | — | 截取配置视口之外的内容 | | number | — | 页面加载后等待的秒数 | | number | 90 | JPEG/WEBP 图像质量 | | number | — | 设备像素比 | | light | dark | auto | auto | 配色方案 | | boolean | false | 移除页面背景（仅限 PNG） | | boolean | false | 截图前冻结 CSS 动画 | | boolean | false | 直接返回图像数据，而非 CDN URL |

`search`

搜索网页并返回清晰、结构化的结果。支持网页、新闻和图片搜索，并可选择生成基于 AI 的回答。

| 参数 | 类型 | 默认值 | 描述 | | ---------------- | --------- | ---------- | -------------------------------------------------- | ---------- | --------------- | ------ | --- | --------------- | | query * | string | — | 搜索查询 | | limit | number | 10 | 结果数量 | | time | string | — | 时间筛选：any、d、w、m、y、d7、h6 | | location | string | — | 用于本地化结果的国家 ISO 代码 | | source | web | news | images | web | 搜索来源 | | category | general | code | pdf | research | linkedin | wiki | — | 搜索类别 | | format | json | markdown | html | json | 响应格式 | | includeDomains | array | — | 仅包含这些域名 | | excludeDomains | array | — | 排除这些域名 | | groundedAnswer | boolean | false | 综合搜索结果生成 AI 回答 | | scrape | boolean | false | 同时抓取排名靠前的结果页面 | | scrapeLimit | number | 3 | 启用 scrape 时要抓取的页面数量 |

`dnsRecord`

查询域名的 DNS 记录。

参数	类型	默认值
`url` *	string	—
`types`	array	所有支持的类型

支持的 DNS 记录类型：

A、AAAA、CNAME、MX、NS、SOA、TXT、CAA、SRV

`siteStatus`

检查网站是否正常运行。

参数	类型	默认值
`url` *	string	—
`proxyCountry`	string	—
`followRedirect`	boolean	`false`

`redirectCheck`

追踪 URL 的完整重定向链。

参数	类型
`url` *	string
`proxyCountry`	string

`brokenLink`

查找网页上的所有失效链接。

参数	类型	默认值
`url` *	string	—
`proxyCountry`	string	—
`followRedirect`	boolean	`false`

`url2Pdf`

将任意 URL 转换为可下载的 PDF。

| 参数 | 类型 | 默认值 | 描述 | | --------------- | ---------- | ----------- | -------------------------- | ----------------- | -------- | ------- | --------- | ---- | ---------- | | url * | 字符串 | — | 目标 URL | | device | desktop | mobile | desktop | 要模拟的设备 | | format | a4 | a3 | a5 | a6 | letter | legal | a0–a2 | a4 | 纸张大小 | | orientation | portrait | landscape | portrait | 页面方向 | | proxyCountry | 字符串 | — | 国家/地区 ISO 代码 | | scale | 数字 | — | 缩放级别 | | margin.top | 数字 | 25 | 顶部边距，单位为 mm | | margin.bottom | 数字 | 25 | 底部边距，单位为 mm | | margin.left | 数字 | 25 | 左侧边距，单位为 mm | | margin.right | 数字 | 25 | 右侧边距，单位为 mm | | hideCookie | 布尔值 | true | 移除 Cookie 横幅 | | skipCaptcha | 布尔值 | true | 绕过反机器人验证 | | addTimestamp | 布尔值 | false | 添加时间戳 |

`openPorts`

扫描主机上的开放端口。可选择对发现的开放端口执行服务和版本检测。

参数	类型	描述	-----	------	------	-----------------------
`url` *	字符串	目标 URL 或主机名
`topPorts`	`50`	`100`	`500`	`1000`	`5000`	扫描最常见的前 N 个端口
`portRanges`	字符串	自定义范围，例如 `"80,443,1000-1010"`
`detectServices`	布尔值	为 `true` 时，还会对开放端口执行服务/版本检测

服务检测

设置 detectServices: true，对发现的开放端口执行 Nmap 服务/版本检测。

{
  "url": "example.com",
  "topPorts": 100,
  "detectServices": true
}

成功时，响应会包含一个 services 数组，其中包含以下信息：

端口号
端口状态
检测到的服务名称
产品名称
产品版本
其他服务信息
可用时推断出的操作系统类型

响应结构示例：

{
  "data": [22, 80, 443],
  "services": [
    {
      "port": 22,
      "state": "open",
      "service": {
        "name": "ssh",
        "product": "OpenSSH",
        "version": "9.6"
      }
    },
    {
      "port": 443,
      "state": "open",
      "service": {
        "name": "https"
      }
    }
  ]
}

服务检测尽力而为，耗时可能比标准端口扫描更长。

如果请求了服务检测，但无法完成，API 可能会返回 servicesError 字段。包含已发现开放端口的 data 字段仍然可用。

`tlsScan`

检查 TLS/SSL 配置——协议、密码套件和证书详情。

参数	类型
`url` *	字符串

`loadTime`

从任意位置测量完整页面加载时间。也可选择同时测试多个位置的可访问性。

参数	类型	默认值	说明
`url` *	string	—	目标 URL
`proxyCountry`	string	—	国家 ISO 代码
`followRedirect`	boolean	`false`	跟随重定向
`targetCountries`	array of string	—	最多 3 个 ISO 国家代码，可通过代理与默认的美国测试同时进行测试。设置后会返回各位置的明细

`mixedContent`

检测混合内容问题（HTTPS 页面上的 HTTP 资源）。

参数	类型	默认值
`url` *	string	—
`proxyCountry`	string	—
`followRedirect`	boolean	`false`

`dnsSec`

检查域名是否启用了 DNSSEC，且配置是否正确。

参数	类型
`url` *	string

`mtr`

运行 MTR（My Traceroute）网络诊断测试。

参数	类型	默认值
`url` *	string	—
`proxyCountry`	string	—
`followRedirect`	boolean	`false`

`ping`

Ping 主机并返回延迟。

参数	类型
`url` *	string

`lighthouse`

运行完整的 Lighthouse 审计，涵盖性能、SEO、无障碍性和最佳实践。

| 参数 | 类型 | 默认值 | 说明 | | ---------------- | --------------- | -------- | -------------------------- | ----------------- | | url * | string | — | 目标 URL | | device | desktop | mobile | desktop | 要模拟的设备 | | proxyCountry | string | — | 国家 ISO 代码 | | followRedirect | boolean | false | 跟随重定向 | | parameters | array of string | — | 额外的 Lighthouse CLI 标志 |

环境变量

变量	必需	说明
`API_KEY`	✅	你的 Geekflare API 密钥
`API_BASE_URL`	—	覆盖 API 基础 URL（默认值：`https://api.geekflare.com`）

链接

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Geekflare

关于 Geekflare

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

@geekflare/mcp

设置

获取 API Key

Claude Desktop

Cursor / Windsurf

Docker

可用工具

webScrape

metaScrape

brand

示例

screenshot

search

dnsRecord

siteStatus

redirectCheck

brokenLink

url2Pdf

openPorts

服务检测

tlsScan

loadTime

mixedContent

dnsSec

mtr

ping

lighthouse