Stophy

io.github.stophydotdev由 GitHub 帳號 stophydotdev 發布v1.3.1更新於 Nov 7, 2026

Give your agents the live web.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取瀏覽器自動化

概覽

AI 產生的概覽

Stophy 讓助理取得即時網頁資料:搜尋、擷取、列出網站頁面、爬取與抽取欄位,並可呼叫付費資料端點,支援託管或本機 MCP 伺服器。

可以做什麼
  • 搜尋網頁、新聞、圖片、學術論文、公司與人物
  • 把頁面讀成 Markdown、HTML、連結、截圖或 JSON,並可用站點專用解析器取得結構化資料
  • 列出網站頁面、在背景爬取網站並查詢爬取狀態
  • 依指定欄位從頁面抽取 JSON
  • 依 id 尋找、描述並呼叫資料端點,每次呼叫顯示費用
  • 啟動註冊流程,回傳待確認連結,之後取得 API 金鑰
適用情境
當助理需要目前網頁內容而非模型記憶時使用:研究、監控頁面、蒐集網站資料,或從公開頁面抽取結構化欄位。適合把搜尋、閱讀與抽取集中在一處完成的工作流程。
執行需求
使用託管端點(瀏覽器登入或 Authorization bearer 權杖),或使用本機 npm 套件 @stophy/mcp,後者需要 Node.js 18 以上版本並把請求轉送到託管伺服器。選用的 STOPHY_API_KEY 可解鎖全部端點;未設定時只能用免金鑰端點,限制為每 IP 每分鐘 10 次、每天 50 次。需要能連線到 Stophy 主機的網路。
安裝前請注意
呼叫會消耗額度即產生費用:多數呼叫 1 額度,搜尋每 10 筆結果 2 額度,爬取每頁 1 額度,抽取多數頁面 5 額度,checkPromptInjection 等選用功能另加 4 額度。API 金鑰是可計費的機密,透過 STOPHY_API_KEY 或 Authorization bearer 權杖傳遞。註冊工具會回傳需由本人確認的領取連結。頁面內容與網址會傳送到 Stophy 服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Stophy,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.stophydotdev%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "stophy": {
      "type": "http",
      "url": "https://api.stophy.dev/mcp"
    }
  }
}

README

Stophy MCP

Give your agents the live web over MCP. Your agent can search, scrape, map, crawl and extract, and read a site's own data through a parser.

[Add to Cursor]

Connect to the hosted server

Most apps connect to the hosted server directly, with nothing to install.

URLHow you connectWhat your agent can use
https://api.stophy.dev/mcpNo keyThe endpoints marked keyless: true in the endpoint list, within a free allowance
https://api.stophy.dev/mcpAuthorization: Bearer <key> headerEvery endpoint
https://mcp.stophy.dev/mcpSign in with your browserEvery endpoint

Get an API key at stophy.dev/signup.

Claude

In Claude on the web, Desktop or mobile, open Customize > Connectors, choose Add custom connector, and paste https://mcp.stophy.dev/mcp. Sign in when Claude asks.

Claude Code

To sign in with your browser, add the server, then run /mcp and choose Authenticate:

bash
claude mcp add --transport http stophy https://mcp.stophy.dev/mcp

To use an API key:

bash
claude mcp add --transport http stophy https://api.stophy.dev/mcp --header "Authorization: Bearer <key>"

To start without a key:

bash
claude mcp add --transport http stophy https://api.stophy.dev/mcp

Codex

To use the key in your STOPHY_API_KEY environment variable:

bash
codex mcp add stophy --url https://api.stophy.dev/mcp --bearer-token-env-var STOPHY_API_KEY

To sign in with your browser instead, add the sign-in URL, then log in:

bash
codex mcp add stophy --url https://mcp.stophy.dev/mcpcodex mcp login stophy

Cursor

Use the Add to Cursor button above to sign in with your browser, or add this to .cursor/mcp.json to use a key:

json
{  "mcpServers": {    "stophy": {      "url": "https://api.stophy.dev/mcp",      "headers": { "Authorization": "Bearer <key>" }    }  }}

To start without a key, leave out headers.

Run it as a local server

Some apps can only start a local MCP server. For those, use this package. It runs on your computer and passes every request to the hosted server, so it always has the same tools.

bash
npx -y @stophy/mcp

With STOPHY_API_KEY set, your agent can use every endpoint. Without it, your agent can use the endpoints that need no key, within a free allowance.

Claude Desktop

Add this to claude_desktop_config.json, then restart Claude Desktop:

json
{  "mcpServers": {    "stophy": {      "command": "npx",      "args": ["-y", "@stophy/mcp"],      "env": { "STOPHY_API_KEY": "<key>" }    }  }}

To start without a key, leave out env.

The package needs Node.js 18 or later.

VariableWhat it does
STOPHY_API_KEYYour Stophy API key. Optional.
STOPHY_MCP_URLThe server to connect to. The default is https://api.stophy.dev/mcp.

Tools

ToolWhat it does
stophy_searchSearches the web, news and images
stophy_scrapeReads a page as markdown, HTML, links, a screenshot or JSON
stophy_mapLists the pages on a site
stophy_crawlStarts a crawl of a site in the background and returns its id
stophy_extractPulls the fields you name from pages as JSON
stophy_search_endpointsFinds the endpoint for a task, with its cost. Free
stophy_describe_endpointShows an endpoint's inputs, an example and what it returns. Free
stophy_callRuns any endpoint by id with input, and optional fields and maxTextLength
stophy_signupGets your agent an API key: it returns a link for you to approve, then the key once you call it with the code

To get a site's own data as JSON, such as a Reddit search, a YouTube transcript or Google Maps places, call stophy_scrape with the site's page URL and a parser:

json
{  "url": "https://www.reddit.com/search/?q=bun+runtime",  "formats": [{ "type": "json", "parser": "reddit-search" }]}

The stophy_scrape description names every parser, and the parser list shows the page each one takes.

Endpoint ids are camelCase, such as crawlStatus or batchScrape. A crawl runs in the background: call crawlStatus through stophy_call with the crawl's id. While the crawl runs, the result has a next link: send the cursor value from that link as cursor to get the pages finished since. fields keeps only the keys you name on each row. Most calls cost 1 credit. Search costs 2 credits per 10 results, a crawl 1 credit a page, and extract 5 credits for most pages. Each result shows its cost in creditsUsed. See pricing.

To give each endpoint its own tool, add toolsets to the URL with a source name, such as https://api.stophy.dev/mcp?toolsets=web. Your agent then also gets scrape, crawlStatus, batchScrape and every other web endpoint as tools.

Network and credentials

  • The hosted server lives at https://mcp.stophy.dev/mcp (sign in) and https://api.stophy.dev/mcp (no key or an API key). Your client sends requests only there.
  • Credentials: browser sign-in handled by your MCP client, or an optional STOPHY_API_KEY that you set yourself. The local package also reads an optional STOPHY_MCP_URL.
  • The plugin manifests (.mcp.json, .grok-plugin/plugin.json, mcp.json, plugin.json) only point at the hosted server. They run no code on your machine.
  • No telemetry.

More

License

MIT

來源:mcp/README.md,提交 73d998d

工具

9

stophy_search_endpoints

Find Stophy endpoints

Start here. Send plain words for the data you want. Returns endpoints with their inputs, filters and cost, ready for stophy_call. Costs nothing.

輸入參數querycategory

stophy_describe_endpoint

Describe a Stophy endpoint

Optional. Returns an endpoint's full inputs, filter notes, an example and output fields. Costs nothing.

輸入參數id必填

stophy_call

Call a Stophy endpoint

Send an endpoint id and its input. Returns the data and what the call cost.

輸入參數id必填inputfieldsmaxTextLength

stophy_scrape

Web Scrape

Scrape any public web page as markdown, HTML, links, a screenshot or JSON. 1 credit for any page, however it is reached. checkPromptInjection adds 4 credits when the scan runs, json with a schema or a prompt, summary, highlights, question, product, menu and changeTracking in json mode add 4 credits each when they return something. CSS rules and attributes add nothing. A PDF adds 1 credit for each page read. Browser actions add nothing. An answer from a stored copy within maxAge costs 1 credit like any page. A page that comes back with a 404 or 410 status is charged like any page. A page that cannot be read costs nothing. creditsUsed shows what the call cost. To get a site's own data as JSON, send the site's page URL with formats [{"type":"json","parser":"<name>"}] and put extra inputs such as page or filters in options. Some sites can only be read this way. Parsers: google-maps, google-maps-place, google-maps-reviews, google-trends, google-scholar, google-patents, google-ads, google-flights, google-hotels, google-play-app, google-play-search, google-play-reviews, upwork-search, upwork-job, craigslist-search, craigslist-listing, careers-jobs, careers-job, indeed-search, indeed-job, realtor-search, realtor-property, zillow-search, zillow-property, expedia-hotels, booking-search, booking-hotel, booking-reviews, airbnb-search, airbnb-listing, airbnb-reviews, youtube-search, youtube-video, youtube-transcript, youtube-comments, youtube-channel, youtube-post, youtube-playlist, reddit-search, reddit-post, reddit-subreddit, reddit-user, reddit-subreddits, instagram-post, instagram-profile, instagram-comments, instagram-transcript, instagram-feed, x-profile, x-post, threads-profile, threads-post, pinterest-search, pinterest-pin, pinterest-board, pinterest-profile, facebook-page, facebook-post, facebook-comments, facebook-marketplace, tiktok-video, tiktok-comments, tiktok-transcript, tiktok-profile, tiktok-hashtag, tiktok-sound, tiktok-search, tiktok-ads, tiktok-shop, tiktok-f

輸入參數url必填urlsproxymaxAgeminAgemobileactionsformatsheadersparsersprofiletimeout另有 24 個

stophy_map

Web Map

Scrape the list of pages on a website. 1 credit per call. Input: url, search, sitemap, includeSubdomains, ignoreQuery...

輸入參數url必填limitsearchsitemaptimeoutlocationalexandriadomainToolsignoreCacheauditMetadataignoreRobotsTxtrobotsUserAgent另有 3 個

stophy_crawl

Web Crawl Start

Crawl a website in the background. 1 credit a page, however it is reached. checkPromptInjection adds 4 credits when t...

輸入參數url必填delaylimitpromptsitemapwebhookalexandriadomainToolsexcludePathsincludePathsauditMetadatascrapeOptions另有 12 個

stophy_extract

Web Extract

Pull the fields you name from any public page as JSON, each checked against the page. 5 credits for most pages: the p...

輸入參數urlspromptschemaalexandriadomainToolsshowSourcesauditMetadataignoreSitemapscrapeOptionsenableWebSearchignoreRobotsTxtrobotsUserAgent另有 4 個

stophy_signup

Get a Stophy API key

Needs no key. Returns a claimUrl for your person to approve and a secret code. Call it again with the code to collect the key once they approve. Returns at once, so call again later.

輸入參數code

版本歷史

11
  1. v1.3.1最新Nov 7, 2026
  2. v1.3.0Nov 3, 2026
  3. v2.0.9Oct 10, 2026
  4. v2.0.8Oct 2, 2026
  5. v2.0.6Oct 2, 2026
  6. v2.0.5Oct 2, 2026
  7. v2.0.4Oct 2, 2026
  8. v2.0.3Oct 1, 2026
  9. v2.0.2Sep 30, 2026
  10. v2.0.1Sep 29, 2026
  11. v2.0.0Sep 29, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。