{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-news-api-skill",
    "name": "Google News Api Skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/phheng/google-news-api-skill",
    "canonicalUrl": "https://clawhub.ai/phheng/google-news-api-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/google-news-api-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-news-api-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/google_news_api.py"
    ],
    "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-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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/google-news-api-skill"
    },
    "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/google-news-api-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/google-news-api-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-news-api-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-news-api-skill/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": "📖 Introduction",
        "body": "This skill provides a one-stop news collection service using BrowserAct's Google News API template. It extracts structured news results directly from Google News, including headlines, sources, publication times, and article links, providing clean and ready-to-use data without manual scraping."
      },
      {
        "title": "✨ Features",
        "body": "No Hallucinations: Uses predefined workflows to ensure stable and accurate data extraction, avoiding AI-generated hallucinations.\nNo CAPTCHA Issues: Built-in mechanisms to bypass reCAPTCHA or other verification challenges automatically.\nNo IP Restrictions: Overcomes regional IP limitations and geofencing for stable global access.\nFast Execution: Executes tasks significantly faster than pure AI-driven browser automation.\nCost-Effective: Reduces data acquisition costs compared to token-heavy AI solutions."
      },
      {
        "title": "🔑 API Key Guidance",
        "body": "Before running, check for the BROWSERACT_API_KEY environment variable. If it is not set, do not proceed with other actions. Instead, request and wait for the user to provide the key.\nAgent must inform the user:\n\n\"Since the BrowserAct API Key is not configured, please go to the BrowserAct Console to get your Key and provide it to me here.\""
      },
      {
        "title": "🛠️ Input Parameters Details",
        "body": "The Agent should configure the following parameters based on user needs when calling the script:\n\nSearch_Keywords\n\nType: string\nDescription: The keywords to search on Google News (e.g., company name, industry terms, competitor names).\nExample: Generative AI, Tesla, SpaceX\n\n\n\nPublish_date\n\nType: string\nDescription: Filters news based on publication time.\nOptions:\n\nany time: No time restriction.\npast hours: Within the last few hours (best for breaking news).\npast 24 hours: Within the last 24 hours (recommended for daily monitoring).\npast week: Within the last week (short-term trend analysis).\npast year: Within the last year (long-term research).\n\n\nDefault: past week\n\n\n\nDatelimit\n\nType: number\nDescription: Maximum number of news items to extract in a single task.\nDefault: 30\nRecommendation: Use 10-30 for real-time monitoring; use larger values for deep research."
      },
      {
        "title": "🚀 How to Call (Recommended)",
        "body": "The Agent should execute the following command to get results:\n\n# Example call\npython -u ./.cursor/skills/google-news-api-skill/scripts/google_news_api.py \"search keywords\" \"time range\" limit"
      },
      {
        "title": "⏳ Progress Monitoring",
        "body": "Since this task involves automated browser operations, it may take several minutes. The script will continuously output timestamped status logs (e.g., [14:30:05] Task Status: running).\nAgent Note:\n\nStay focused on the terminal output while waiting for the script.\nAs long as new status logs are being printed, the task is running normally. Do not assume it is hung or unresponsive.\nOnly consider retrying if the status remains unchanged for a long time or the script stops without returning results."
      },
      {
        "title": "📊 Output Data Specification",
        "body": "Upon success, the script prints results parsed from the API response. Fields include:\n\nheadline: Title of the news article.\nsource: Publisher or news outlet.\nnews_link: Resolved destination URL of the article.\npublished_time: Timestamp displayed on Google News.\nauthor: Name of the author (if available)."
      },
      {
        "title": "⚠️ Error Handling & Retry Mechanism",
        "body": "If an error occurs (e.g., network issues or task failure), follow this logic:\n\nCheck Output:\n\nIf output contains \"Invalid authorization\", the API Key is invalid. Do not retry. Guide the user to provide a correct API Key.\nIf output does not contain \"Invalid authorization\" but the task fails (e.g., output starts with Error: or result is empty), the Agent should automatically retry once.\n\n\n\nRetry Limit:\n\nAutomatic retry is limited to one attempt. If it fails again, stop and report the error message to the user."
      },
      {
        "title": "🌟 Typical Use Cases",
        "body": "Industry Trend Tracking: Find the latest developments in fields like \"Low-altitude economy\" or \"Generative AI\".\nPR Monitoring: Monitor media exposure of a specific brand or company over the past 24 hours.\nCompetitor Intelligence: Collect information on new products or marketing activities from competitors over the past week.\nMarket Research: Get popular reports on specific keywords across different time dimensions.\nIndividual Tracking: Retrieve the latest news reports on industry leaders or public figures.\nDaily News Summary: Automatically extract and summarize daily news in specific domains.\nGlobal Breaking News: Get real-time updates on major global events.\nStructured Data Extraction: Extract structured information like headlines, sources, and links for analysis.\nMedia Exposure Analysis: Evaluate the propagation heat of a project or event in mainstream news media.\nLong-term Research: Retrieve all in-depth reports on a specific technical topic from the past year."
      }
    ],
    "body": "Google News Automation Skill\n📖 Introduction\n\nThis skill provides a one-stop news collection service using BrowserAct's Google News API template. It extracts structured news results directly from Google News, including headlines, sources, publication times, and article links, providing clean and ready-to-use data without manual scraping.\n\n✨ Features\nNo Hallucinations: Uses predefined workflows to ensure stable and accurate data extraction, avoiding AI-generated hallucinations.\nNo CAPTCHA Issues: Built-in mechanisms to bypass reCAPTCHA or other verification challenges automatically.\nNo IP Restrictions: Overcomes regional IP limitations and geofencing for stable global access.\nFast Execution: Executes tasks significantly faster than pure AI-driven browser automation.\nCost-Effective: Reduces data acquisition costs compared to token-heavy AI solutions.\n🔑 API Key Guidance\n\nBefore running, check for the BROWSERACT_API_KEY environment variable. If it is not set, do not proceed with other actions. Instead, request and wait for the user to provide the key. Agent must inform the user:\n\n\"Since the BrowserAct API Key is not configured, please go to the BrowserAct Console to get your Key and provide it to me here.\"\n\n🛠️ Input Parameters Details\n\nThe Agent should configure the following parameters based on user needs when calling the script:\n\nSearch_Keywords\n\nType: string\nDescription: The keywords to search on Google News (e.g., company name, industry terms, competitor names).\nExample: Generative AI, Tesla, SpaceX\n\nPublish_date\n\nType: string\nDescription: Filters news based on publication time.\nOptions:\nany time: No time restriction.\npast hours: Within the last few hours (best for breaking news).\npast 24 hours: Within the last 24 hours (recommended for daily monitoring).\npast week: Within the last week (short-term trend analysis).\npast year: Within the last year (long-term research).\nDefault: past week\n\nDatelimit\n\nType: number\nDescription: Maximum number of news items to extract in a single task.\nDefault: 30\nRecommendation: Use 10-30 for real-time monitoring; use larger values for deep research.\n🚀 How to Call (Recommended)\n\nThe Agent should execute the following command to get results:\n\n# Example call\npython -u ./.cursor/skills/google-news-api-skill/scripts/google_news_api.py \"search keywords\" \"time range\" limit\n\n⏳ Progress Monitoring\n\nSince this task involves automated browser operations, it may take several minutes. The script will continuously output timestamped status logs (e.g., [14:30:05] Task Status: running). Agent Note:\n\nStay focused on the terminal output while waiting for the script.\nAs long as new status logs are being printed, the task is running normally. Do not assume it is hung or unresponsive.\nOnly consider retrying if the status remains unchanged for a long time or the script stops without returning results.\n📊 Output Data Specification\n\nUpon success, the script prints results parsed from the API response. Fields include:\n\nheadline: Title of the news article.\nsource: Publisher or news outlet.\nnews_link: Resolved destination URL of the article.\npublished_time: Timestamp displayed on Google News.\nauthor: Name of the author (if available).\n⚠️ Error Handling & Retry Mechanism\n\nIf an error occurs (e.g., network issues or task failure), follow this logic:\n\nCheck Output:\n\nIf output contains \"Invalid authorization\", the API Key is invalid. Do not retry. Guide the user to provide a correct API Key.\nIf output does not contain \"Invalid authorization\" but the task fails (e.g., output starts with Error: or result is empty), the Agent should automatically retry once.\n\nRetry Limit:\n\nAutomatic retry is limited to one attempt. If it fails again, stop and report the error message to the user.\n🌟 Typical Use Cases\nIndustry Trend Tracking: Find the latest developments in fields like \"Low-altitude economy\" or \"Generative AI\".\nPR Monitoring: Monitor media exposure of a specific brand or company over the past 24 hours.\nCompetitor Intelligence: Collect information on new products or marketing activities from competitors over the past week.\nMarket Research: Get popular reports on specific keywords across different time dimensions.\nIndividual Tracking: Retrieve the latest news reports on industry leaders or public figures.\nDaily News Summary: Automatically extract and summarize daily news in specific domains.\nGlobal Breaking News: Get real-time updates on major global events.\nStructured Data Extraction: Extract structured information like headlines, sources, and links for analysis.\nMedia Exposure Analysis: Evaluate the propagation heat of a project or event in mainstream news media.\nLong-term Research: Retrieve all in-depth reports on a specific technical topic from the past year."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/phheng/google-news-api-skill",
    "publisherUrl": "https://clawhub.ai/phheng/google-news-api-skill",
    "owner": "phheng",
    "version": "0.1.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-news-api-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/google-news-api-skill",
    "agentUrl": "https://openagent3.xyz/skills/google-news-api-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-news-api-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-news-api-skill/agent.md"
  }
}