{
  "schemaVersion": "1.0",
  "item": {
    "slug": "serper-search",
    "name": "serper-search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Samoppakiks/serper-search",
    "canonicalUrl": "https://clawhub.ai/Samoppakiks/serper-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/serper-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=serper-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "package.json",
      "SKILL.md",
      "index.ts",
      "clawdbot.plugin.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/serper-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/serper-search",
    "agentPageUrl": "https://openagent3.xyz/skills/serper-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/serper-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/serper-search/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Serper Google Search Plugin",
        "body": "Native Clawdbot plugin for Google Search via Serper.dev API. Returns real Google results — organic links, knowledge graph, news, and \"People Also Ask\" — as a single tool call."
      },
      {
        "title": "When to use",
        "body": "You need actual Google results with links and snippets (not AI-synthesized answers)\nYou want Google News articles on a topic\nYou need knowledge graph data (quick facts, entity info)\nComplements AI search tools (Perplexity, Brave) with raw Google data"
      },
      {
        "title": "Setup",
        "body": "Get a free API key at serper.dev (2,500 searches/month, no card required)\nSet the environment variable in your Clawdbot config:\n\n{\n  \"env\": {\n    \"vars\": {\n      \"SERPER_API_KEY\": \"your-api-key-here\"\n    }\n  }\n}\n\nOr configure directly in the plugin entry:\n\n{\n  \"plugins\": {\n    \"entries\": {\n      \"serper-search\": {\n        \"enabled\": true,\n        \"config\": {\n          \"apiKey\": \"your-api-key-here\",\n          \"defaultNumResults\": 5\n        }\n      }\n    }\n  }\n}"
      },
      {
        "title": "Usage",
        "body": "The plugin registers a serper_search tool with three parameters:\n\nParameterTypeDefaultDescriptionquerystringrequiredThe search querynumnumber5Number of results (1-100)searchTypestring\"search\"\"search\" for web, \"news\" for news"
      },
      {
        "title": "Web search",
        "body": "Search for \"best rust web frameworks 2026\"\n\nReturns organic results with title, link, snippet, and position, plus knowledge graph and related questions."
      },
      {
        "title": "News search",
        "body": "Search news for \"AI regulation Europe\"\n\nReturns news articles with title, link, snippet, date, and source."
      },
      {
        "title": "Plugin structure",
        "body": "serper-search/\n  clawdbot.plugin.json   # Plugin manifest with configSchema\n  package.json            # NPM package config\n  index.ts                # Plugin implementation\n  SKILL.md                # This file"
      },
      {
        "title": "Key implementation details",
        "body": "Export: export default function register(api) — not an object\nTool registration: api.registerTool(toolObject) — direct, not callback\nReturn format: { content: [{ type: \"text\", text: JSON.stringify(results) }] }\nDependencies: Symlink @sinclair/typebox from Clawdbot's own node_modules"
      },
      {
        "title": "Author",
        "body": "Built by @Samoppakiks with Claude Code."
      }
    ],
    "body": "Serper Google Search Plugin\n\nNative Clawdbot plugin for Google Search via Serper.dev API. Returns real Google results — organic links, knowledge graph, news, and \"People Also Ask\" — as a single tool call.\n\nWhen to use\nYou need actual Google results with links and snippets (not AI-synthesized answers)\nYou want Google News articles on a topic\nYou need knowledge graph data (quick facts, entity info)\nComplements AI search tools (Perplexity, Brave) with raw Google data\nSetup\nGet a free API key at serper.dev (2,500 searches/month, no card required)\nSet the environment variable in your Clawdbot config:\n{\n  \"env\": {\n    \"vars\": {\n      \"SERPER_API_KEY\": \"your-api-key-here\"\n    }\n  }\n}\n\n\nOr configure directly in the plugin entry:\n\n{\n  \"plugins\": {\n    \"entries\": {\n      \"serper-search\": {\n        \"enabled\": true,\n        \"config\": {\n          \"apiKey\": \"your-api-key-here\",\n          \"defaultNumResults\": 5\n        }\n      }\n    }\n  }\n}\n\nUsage\n\nThe plugin registers a serper_search tool with three parameters:\n\nParameter\tType\tDefault\tDescription\nquery\tstring\trequired\tThe search query\nnum\tnumber\t5\tNumber of results (1-100)\nsearchType\tstring\t\"search\"\t\"search\" for web, \"news\" for news\nWeb search\n\nSearch for \"best rust web frameworks 2026\"\n\nReturns organic results with title, link, snippet, and position, plus knowledge graph and related questions.\n\nNews search\n\nSearch news for \"AI regulation Europe\"\n\nReturns news articles with title, link, snippet, date, and source.\n\nPlugin structure\nserper-search/\n  clawdbot.plugin.json   # Plugin manifest with configSchema\n  package.json            # NPM package config\n  index.ts                # Plugin implementation\n  SKILL.md                # This file\n\nKey implementation details\nExport: export default function register(api) — not an object\nTool registration: api.registerTool(toolObject) — direct, not callback\nReturn format: { content: [{ type: \"text\", text: JSON.stringify(results) }] }\nDependencies: Symlink @sinclair/typebox from Clawdbot's own node_modules\nAuthor\n\nBuilt by @Samoppakiks with Claude Code."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Samoppakiks/serper-search",
    "publisherUrl": "https://clawhub.ai/Samoppakiks/serper-search",
    "owner": "Samoppakiks",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/serper-search",
    "downloadUrl": "https://openagent3.xyz/downloads/serper-search",
    "agentUrl": "https://openagent3.xyz/skills/serper-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/serper-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/serper-search/agent.md"
  }
}