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 分