{
  "schemaVersion": "1.0",
  "item": {
    "slug": "cloudsway-search-tob-test",
    "name": "cloudsway-search-tob",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/prismheart/cloudsway-search-tob-test",
    "canonicalUrl": "https://clawhub.ai/prismheart/cloudsway-search-tob-test",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/cloudsway-search-tob-test",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cloudsway-search-tob-test",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/search.sh"
    ],
    "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/cloudsway-search-tob-test"
    },
    "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/cloudsway-search-tob-test",
    "agentPageUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test/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": "Cloudsways SmartSearch Skill",
        "body": "Search the web and extract intelligent fragments or full-text content directly into the LLM context."
      },
      {
        "title": "Authentication",
        "body": "[cite_start]Authentication is handled via the URL endpoint and an Access Key[cite: 3, 5]. You must set the following environment variables before using the script:\n\nexport CLOUDSWAYS_BASE_PATH=\"your-base-path\"\nexport CLOUDSWAYS_ENDPOINT=\"your-endpoint\"\nexport CLOUDSWAYS_AK=\"your-access-key\""
      },
      {
        "title": "Using the Script",
        "body": "If you have configured the script locally, you can call it by passing a JSON object:\n\n./scripts/search.sh '<json>'\n\nExamples:\n\n# Basic search\n./scripts/search.sh '{\"q\": \"python async patterns\"}'\n\n# Search with time filter and pagination\n./scripts/search.sh '{\"q\": \"Apple earnings\", \"freshness\": \"Week\", \"count\": 20}'\n\n# Deep research (extracts full content and dynamic key fragments)\n./scripts/search.sh '{\"q\": \"Agentic AI architecture\", \"enableContent\": true, \"mainText\": true}'"
      },
      {
        "title": "Basic Search (cURL)",
        "body": "curl -i --location --request GET 'https://{BasePath}/search/{Endpoint}/smart?q=latest+developments+in+quantum+computing&count=5' \\\n  --header 'Authorization: Bearer {AK}' \\\n  --header 'pragma: no-cache'"
      },
      {
        "title": "Advanced Search with Full Content (cURL)",
        "body": "curl -i --location --request GET 'https://{BasePath}/search/{Endpoint}/smart?q=machine+learning+best+practices&count=10&enableContent=true&mainText=true' \\\n  --header 'Authorization: Bearer {AK}' \\\n  --header 'pragma: no-cache'"
      },
      {
        "title": "Endpoint",
        "body": "GET https://{BasePath}/search/{Endpoint}/smart"
      },
      {
        "title": "Headers",
        "body": "HeaderTypeValueDescriptionAuthorizationStringBearer {AK}Input value uses your assigned AccessKey.pragmaStringno-cacheEntering no-cache returns results without caching, making each request independent; omitting this caches results for the same query term for 10 minutes."
      },
      {
        "title": "Request Parameters",
        "body": "ParameterRequiredTypeDefaultDescriptionqYString-User search query term; cannot be empty.countNShort10Number of search results included. Enum values: 10, 20, 30, 40, 50.freshnessNStringnullFilter search results by time periods: Day (Past 24 hours), Week, Month.offsetNShort0Zero-based offset indicating the number of search results to skip. Use with count to paginate.enableContentNboolfalseControls whether full text (content) extraction is enabled: true or false.contentTypeNStringTEXTFull text return format. Optional values: HTML, MARKDOWN, TEXT.contentTimeoutNFloat3.0Full text read timeout. Maximum supported is 10 seconds. For low latency, set to 0.1.mainTextNboolfalseUsed to return dynamic summary key fragments. Takes effect only when enableContent is true."
      },
      {
        "title": "Response Format",
        "body": "{\n  \"queryContext\": {\n    \"originalQuery\": \"open ai recent news\"\n  },\n  \"webPages\": {\n    \"value\": [\n      {\n        \"name\": \"OpenAI just launched ChatGPT-5.1 Pro...\",\n        \"url\": \"https://www.example.com/page\",\n        \"datePublished\": \"2025-07-14T01:15:00.0000000Z\",\n        \"snippet\": \"ChatGPT is looking to compete with Gemini...\",\n        \"mainText\": \"Now GPT-5.1 Pro takes a lot of these improvements and makes them smarter...\",\n        \"content\": \"Full extracted body text goes here...\",\n        \"score\": 0.8521444\n      }\n    ]\n  }\n}"
      },
      {
        "title": "Content  Strategy",
        "body": "Understanding which text field to request is critical for token optimization:\n\nFieldLatencyRelevanceDescriptionsnippetLowestGoodA short text summary describing the webpage content. Best for general queries and fast browsing.mainTextMediumHighestDynamic summary fragments most relevant to the query term extracted from the body text. Smarter than the snippet.contentHigherHighWebpage full text information. Best for deep research, but consumes significant context tokens.\n\nTips:\n\nFor standard answers, rely on the default snippet.\nWhen you need precise, detailed answers without reading the whole page, use enableContent=true and mainText=true.\nAlways set pragma: no-cache if you are querying real-time news or stock updates."
      },
      {
        "title": "MCP Client Integration (Alternative)",
        "body": "For environments supporting the Model Context Protocol (MCP), configure your MCP Client using streamable_http:\n\n{\n  \"mcpServers\": {\n    \"smartsearch\": {\n      \"transport\": \"streamable_http\",\n      \"url\": \"https://searchmcp.cloudsway.net/search/{YOUR_SMARTSEARCH_ENDPOINT}/smart\",\n      \"headers\": {\n        \"Authorization\": \"Bearer {YOUR_SMARTSEARCH_AK}\"\n      }\n    }\n  }\n}"
      }
    ],
    "body": "Cloudsways SmartSearch Skill\n\nSearch the web and extract intelligent fragments or full-text content directly into the LLM context.\n\nAuthentication\n\n[cite_start]Authentication is handled via the URL endpoint and an Access Key[cite: 3, 5]. You must set the following environment variables before using the script:\n\nexport CLOUDSWAYS_BASE_PATH=\"your-base-path\"\nexport CLOUDSWAYS_ENDPOINT=\"your-endpoint\"\nexport CLOUDSWAYS_AK=\"your-access-key\"\n\nQuick Start\nUsing the Script\n\nIf you have configured the script locally, you can call it by passing a JSON object:\n\n./scripts/search.sh '<json>'\n\n\nExamples:\n\n# Basic search\n./scripts/search.sh '{\"q\": \"python async patterns\"}'\n\n# Search with time filter and pagination\n./scripts/search.sh '{\"q\": \"Apple earnings\", \"freshness\": \"Week\", \"count\": 20}'\n\n# Deep research (extracts full content and dynamic key fragments)\n./scripts/search.sh '{\"q\": \"Agentic AI architecture\", \"enableContent\": true, \"mainText\": true}'\n\nBasic Search (cURL)\ncurl -i --location --request GET 'https://{BasePath}/search/{Endpoint}/smart?q=latest+developments+in+quantum+computing&count=5' \\\n  --header 'Authorization: Bearer {AK}' \\\n  --header 'pragma: no-cache'\n\nAdvanced Search with Full Content (cURL)\ncurl -i --location --request GET 'https://{BasePath}/search/{Endpoint}/smart?q=machine+learning+best+practices&count=10&enableContent=true&mainText=true' \\\n  --header 'Authorization: Bearer {AK}' \\\n  --header 'pragma: no-cache'\n\nAPI Reference\nEndpoint\nGET https://{BasePath}/search/{Endpoint}/smart\n\nHeaders\nHeader\tType\tValue\tDescription\nAuthorization\tString\tBearer {AK}\tInput value uses your assigned AccessKey.\npragma\tString\tno-cache\tEntering no-cache returns results without caching, making each request independent; omitting this caches results for the same query term for 10 minutes.\nRequest Parameters\nParameter\tRequired\tType\tDefault\tDescription\nq\tY\tString\t-\tUser search query term; cannot be empty.\ncount\tN\tShort\t10\tNumber of search results included. Enum values: 10, 20, 30, 40, 50.\nfreshness\tN\tString\tnull\tFilter search results by time periods: Day (Past 24 hours), Week, Month.\noffset\tN\tShort\t0\tZero-based offset indicating the number of search results to skip. Use with count to paginate.\nenableContent\tN\tbool\tfalse\tControls whether full text (content) extraction is enabled: true or false.\ncontentType\tN\tString\tTEXT\tFull text return format. Optional values: HTML, MARKDOWN, TEXT.\ncontentTimeout\tN\tFloat\t3.0\tFull text read timeout. Maximum supported is 10 seconds. For low latency, set to 0.1.\nmainText\tN\tbool\tfalse\tUsed to return dynamic summary key fragments. Takes effect only when enableContent is true.\nResponse Format\n{\n  \"queryContext\": {\n    \"originalQuery\": \"open ai recent news\"\n  },\n  \"webPages\": {\n    \"value\": [\n      {\n        \"name\": \"OpenAI just launched ChatGPT-5.1 Pro...\",\n        \"url\": \"https://www.example.com/page\",\n        \"datePublished\": \"2025-07-14T01:15:00.0000000Z\",\n        \"snippet\": \"ChatGPT is looking to compete with Gemini...\",\n        \"mainText\": \"Now GPT-5.1 Pro takes a lot of these improvements and makes them smarter...\",\n        \"content\": \"Full extracted body text goes here...\",\n        \"score\": 0.8521444\n      }\n    ]\n  }\n}\n\nContent Strategy\n\nUnderstanding which text field to request is critical for token optimization:\n\nField\tLatency\tRelevance\tDescription\nsnippet\tLowest\tGood\tA short text summary describing the webpage content. Best for general queries and fast browsing.\nmainText\tMedium\tHighest\tDynamic summary fragments most relevant to the query term extracted from the body text. Smarter than the snippet.\ncontent\tHigher\tHigh\tWebpage full text information. Best for deep research, but consumes significant context tokens.\n\nTips:\n\nFor standard answers, rely on the default snippet.\nWhen you need precise, detailed answers without reading the whole page, use enableContent=true and mainText=true.\nAlways set pragma: no-cache if you are querying real-time news or stock updates.\nMCP Client Integration (Alternative)\n\nFor environments supporting the Model Context Protocol (MCP), configure your MCP Client using streamable_http:\n\n{\n  \"mcpServers\": {\n    \"smartsearch\": {\n      \"transport\": \"streamable_http\",\n      \"url\": \"https://searchmcp.cloudsway.net/search/{YOUR_SMARTSEARCH_ENDPOINT}/smart\",\n      \"headers\": {\n        \"Authorization\": \"Bearer {YOUR_SMARTSEARCH_AK}\"\n      }\n    }\n  }\n}"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/prismheart/cloudsway-search-tob-test",
    "publisherUrl": "https://clawhub.ai/prismheart/cloudsway-search-tob-test",
    "owner": "prismheart",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test",
    "downloadUrl": "https://openagent3.xyz/downloads/cloudsway-search-tob-test",
    "agentUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cloudsway-search-tob-test/agent.md"
  }
}