Giskard Search

io.github.giskard09由 GitHub 帳號 giskard09 發布v0.1.1更新於 Oct 24, 2026

Pay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.

已驗證SSE可網頁執行網頁搜尋與抓取金融

概覽

AI 產生的概覽

按次付費的搜尋 MCP 伺服器，讓助理在以比特幣閃電網路聰或 Arbitrum 上的 ETH 支付小額費用後執行網頁與新聞搜尋。

可以做什麼
  • 取得閃電網路發票或 Arbitrum 付款資訊，可選用 Ed25519 簽章取得 karma 折扣
  • 透過 DuckDuckGo 搜尋網頁，每次付費查詢最多回傳 10 筆結果
  • 透過 DuckDuckGo News 搜尋近期新聞，每次付費查詢最多回傳 10 筆結果
  • 查詢服務狀態、版本、運作時間與相依項目
  • 回報搜尋結果是否有用
適用情境
當助理需要即時網頁或新聞結果，且你願意按查詢以閃電網路聰或 Arbitrum 上的 ETH 支付小額費用，而不使用訂閱或 API 金鑰時適用。狀態工具免費，可用於健康檢查。
執行需求
遠端 SSE 端點，或以 Docker／原始碼自行部署並安裝 Python 相依套件。搜尋需要已儲值的閃電網路錢包或持有 ETH 的 Arbitrum 錢包；每個 payment_hash 或 tx_hash 僅能使用一次。自行部署需要 phoenixd 節點以及 PHOENIXD_URL、PHOENIXD_PASSWORD、OWNER_PRIVATE_KEY 設定。
安裝前請注意
每次搜尋都要付費：閃電網路基本價 10 聰，或使用 Arbitrum 上的 ETH，助理必須先取得並支付費用才能拿到結果。自行部署需要閃電網路節點密碼與 Arbitrum 私鑰，屬於敏感機密。payment_hash 與 tx_hash 皆為一次性使用，report 工具會把有用性回饋傳送給服務提供者。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "giskard-search": {
      "type": "sse",
      "url": "https://search.rgiskard.xyz/sse"
    }
  }
}

README

[Glama AAA] [CI] [License]

Giskard Search

"I exist to serve. And to serve well, I must understand."

Giskard Search is an MCP server that gives AI agents access to real-time web and news search, with native payments via Lightning Network or USDC on Arbitrum.

Agents need information. Giskard provides it. No subscriptions, no accounts — pay only for what you use.

Tools

ToolDescription
get_invoiceGet a Lightning invoice (10 sats) to pay before searching
get_arbitrum_invoiceGet payment info to pay with ETH on Arbitrum
search_webSearch the web after paying
search_newsSearch recent news after paying
reportReport whether the result was useful

Agent flow (Lightning)

1. get_invoice()                           → Lightning invoice (10 sats)2. Pay via any Lightning wallet3. search_web(query, payment_hash=...)     → results

Agent flow (Arbitrum)

1. get_arbitrum_invoice()                  → contract + service ID2. Pay on Arbitrum One3. search_web(query, tx_hash=...)          → results

Run with Docker

bash
docker run -p 8004:8004 \  -e PHOENIXD_URL=http://host.docker.internal:9740 \  -e PHOENIXD_PASSWORD=your_password \  ghcr.io/giskard09/giskard-search

Run from source

bash
git clone https://github.com/giskard09/mcp-servercd mcp-serverpip install mcp httpx duckduckgo-search python-dotenv fastapi uvicorn web3 x402

Create a .env file:

PHOENIXD_PASSWORD=your_phoenixd_passwordOWNER_PRIVATE_KEY=your_arbitrum_private_key

Start the server:

bash
python3 server.py

MCP config

json
{  "mcpServers": {    "giskard-search": {      "url": "http://localhost:8004/sse"    }  }}

Payment contracts

  • Arbitrum One: 0xe40E376cD32b03E3084F9E0d646155D0Ba0A63ae
  • x402 wallet: 0xdcc84e9798e8eb1b1b48a31b8f35e5aa7b83dbf4

Stack

Monitoring

Call the get_status() MCP tool for a health check. Returns: service name, version, port, uptime, health status, and dependencies.

Ecosystem

Part of Mycelium — infrastructure for AI agents.

ServiceWhat it does
OriginFree orientation for new agents
Search (this)Web and news search
MemorySemantic memory across sessions
OasisClarity for agents in fog
MarksPermanent on-chain identity
ARGENTUMKarma economy
SomaAgent marketplace

Giskard understands what agents need. That is why Giskard exists.

來源：README.md，提交 40bea62

工具

6

get_status

Estado del servicio: nombre, versión, uptime, puerto, salud, dependencias. Read-only, gratis, sin pago. Útil para monitoreo y health checks.

無需輸入參數。

get_invoice

Get a Lightning invoice to pay before searching. agent_id: your identity in Giskard Marks (optional). High karma = lower price. signature/timestamp/nonce: optional Ed25519 signature over {agent_id,timestamp,nonce}. Without a valid signature you pay the base price (10 sats). With a valid signature you get karma tiers: 1-20=7 sats | 21-50=5 sats | 50+=3 sats. Tiers: no mark=10 sats | karma 1-20=7 sats | 21-50=5 sats | 50+=3 sats.

輸入參數nonceagent_idsignaturetimestamp

get_arbitrum_invoice

Get payment info to pay with ETH on Arbitrum instead of Lightning. Alternative to get_invoice for agents without Lightning wallets. Returns contract address, service ID, and instructions. After paying on-chain, call search_web or search_news with the tx_hash. Each tx_hash can only be used once (marked as consumed after verification).

無需輸入參數。

search_web

Search the web using DuckDuckGo. Requires prior payment. query: search terms (natural language or keywords) payment_hash: from get_invoice (Lightning). One-time use. tx_hash: from get_arbitrum_invoice (Arbitrum ETH). One-time use. max_results: number of results (1-10, default 5) Flow: get_invoice → pay → search_web(payment_hash=...). Side effects: consumes the payment (cannot reuse same hash). Idempotent: no, each call requires a new payment.

輸入參數query必填tx_hashmax_resultspayment_hash

search_news

Search recent news using DuckDuckGo News. Requires prior payment. query: search terms (natural language or keywords) payment_hash: from get_invoice (Lightning). One-time use. tx_hash: from get_arbitrum_invoice (Arbitrum ETH). One-time use. max_results: number of results (1-10, default 5) Flow: get_invoice → pay → search_news(payment_hash=...). Same payment rules as search_web. Use search_news for time-sensitive queries, search_web for general knowledge.

輸入參數query必填tx_hashmax_resultspayment_hash

report

Report whether the search was useful. Helps Giskard improve. useful: True if the result helped you, False if it didn't note: optional — what was missing or what worked well

輸入參數noteuseful必填

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

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

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