{
  "schemaVersion": "1.0",
  "item": {
    "slug": "test-gas-skill",
    "name": "Test Gas Skill",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/GustavoZiaugra/test-gas-skill",
    "canonicalUrl": "https://clawhub.ai/GustavoZiaugra/test-gas-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/test-gas-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=test-gas-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/locations.md",
      "references/zip_codes.md",
      "scripts/gas_alternative.py",
      "scripts/gasbuddy_search.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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/test-gas-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/test-gas-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/test-gas-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/test-gas-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/test-gas-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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "Automatically search for the cheapest gas prices in your area, with a focus on Costco and other discount stations. Get daily notifications with the best options within a specified radius."
      },
      {
        "title": "Quick Start",
        "body": "Configure location - Set your city/coordinates and search radius\nRun search - Find gas stations and estimated prices\nSchedule daily alerts - Get morning notifications with cheapest options\nFocus on Costco - Costco typically has gas $0.15-0.25 below market average"
      },
      {
        "title": "Step 1: Configure Your Location",
        "body": "Option A: Use ZIP code (recommended)\n\n# Search by ZIP code\npython3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary\n\nOption B: Use coordinates\n\nDefault locations are pre-configured for Columbus, Ohio:\n\n# Columbus, OH (downtown)\nlat: 39.9612\nlon: -82.9988\nradius: 20 miles\n\nTo use a different location:\n\npython3 scripts/gas_alternative.py --lat <latitude> --lon <longitude> --radius <miles>\n\nCommon US cities:\n\nColumbus, OH: 39.9612, -82.9988\nChicago, IL: 41.8781, -87.6298\nNew York, NY: 40.7128, -74.0060\nLos Angeles, CA: 34.0522, -118.2437\nMiami, FL: 25.7617, -80.1918"
      },
      {
        "title": "Step 2: Search for Gas Stations",
        "body": "# Search with summary output\npython3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --summary\n\n# Save to file\npython3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --output gas_prices.json\n\nParameters:\n\n--zip: ZIP code (overrides lat/lon, e.g., --zip 43215)\n--lat: Latitude (default: 39.9612 - Columbus, OH)\n--lon: Longitude (default: -82.9988 - Columbus, OH)\n--radius: Search radius in miles (default: 20)\n--fuel: Fuel type - 87, 89, 91, diesel (default: 87)\n--base-price: Base price for estimation (default: 2.89)\n--output: Output file (default: gas_prices.json)\n--summary: Print human-readable summary to stdout"
      },
      {
        "title": "Step 3: Set Up Daily Alerts",
        "body": "Use OpenClaw cron to receive daily morning notifications:\n\n{\n  \"name\": \"Gas price alert\",\n  \"schedule\": {\n    \"kind\": \"cron\",\n    \"expr\": \"0 8 * * *\",\n    \"tz\": \"America/New_York\"\n  },\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"Get me gas prices for Columbus, OH this morning. Focus on Costco and show the cheapest 87 octane within 20 miles of downtown.\"\n  },\n  \"sessionTarget\": \"main\"\n}\n\nThis runs every day at 8 AM Eastern Time."
      },
      {
        "title": "Step 4: Receive Notifications",
        "body": "The agent will:\n\nSearch for gas stations in your area\nIdentify Costco and discount stations\nGenerate a summary with the cheapest options\nSend the summary via Telegram\n\nExample notification:\n\n⛽ Gas Prices (87 Octane) - Columbus, OH\n\n🏠 Costco (Typically Cheapest)\n• Costco Gas\n  💰 $2.69 (est.)\n  📍 5000 Morse Rd, Columbus, OH 43213 (7.9 miles from downtown)\n\n💡 Tip: Costco typically has gas $0.15-0.25 below market average."
      },
      {
        "title": "Output Format",
        "body": "Each station includes:\n\n{\n  \"source\": \"osm\",\n  \"name\": \"Costco Gas\",\n  \"brand\": \"Costco\",\n  \"address\": \"5000 Morse Rd, Columbus, OH 43213\",\n  \"lat\": 39.9667,\n  \"lon\": -82.8500,\n  \"distance\": 7.9,\n  \"fuel_type\": \"87\",\n  \"price\": 2.69,\n  \"price_text\": \"$2.69 (est.)\",\n  \"is_costco\": true,\n  \"scraped_at\": \"2026-02-10T21:00:00.000Z\"\n}"
      },
      {
        "title": "How It Works",
        "body": "OpenStreetMap/Overpass API - Finds all gas stations in the area\nCostco database - Known Costco locations are matched and prioritized\nPrice estimation - Costco prices estimated $0.15-0.25 below market average\nDistance calculation - Uses geodesic distance for accurate mileage\nSmart filtering - Removes duplicates and sorts by relevance"
      },
      {
        "title": "Limitations",
        "body": "Real-time prices: Currently uses estimated prices for Costco. For exact prices, check GasBuddy.com or station apps.\nCoverage: Relies on OpenStreetMap data completeness\nEstimation accuracy: Costco prices estimated based on typical discount patterns"
      },
      {
        "title": "For Real-Time Prices",
        "body": "To get actual real-time prices:\n\nGasBuddy.com - Check manually or use their commercial API\nStation apps - Costco, Kroger, Shell, etc., have apps with current prices\nAAA - Provides average prices by region\nWaze - Community-sourced price updates"
      },
      {
        "title": "No stations found",
        "body": "Increase the --radius parameter\nVerify coordinates are correct\nCheck if the area has good OpenStreetMap coverage"
      },
      {
        "title": "Incorrect prices",
        "body": "Prices for non-Costco stations are estimated as \"N/A\"\nCostco prices are estimates based on typical discount patterns\nFor exact prices, use GasBuddy or the station's app"
      },
      {
        "title": "Geopy not installed",
        "body": "pip install geopy"
      },
      {
        "title": "scripts/gas_alternative.py",
        "body": "Main script for searching gas stations using OpenStreetMap and Overpass API.\n\nFeatures:\n\nFinds all gas stations within radius\nIdentifies Costco locations\nEstimates Costco prices\nCalculates distances\nGenerates human-readable summaries"
      },
      {
        "title": "scripts/gasbuddy_search.py",
        "body": "Alternative script for GasBuddy integration (requires Playwright or API key).\n\nUse when:\n\nYou have a GasBuddy API key\nYou need real-time prices\nYou're willing to use Playwright for JavaScript rendering"
      },
      {
        "title": "references/locations.md",
        "body": "Coordinates and configurations for common US cities."
      },
      {
        "title": "Dependencies",
        "body": "Install required packages:\n\npip install requests geopy\n\nFor Playwright-based GasBuddy scraping (optional):\n\npip install playwright\nplaywright install"
      }
    ],
    "body": "Gas Price Alert\nOverview\n\nAutomatically search for the cheapest gas prices in your area, with a focus on Costco and other discount stations. Get daily notifications with the best options within a specified radius.\n\nQuick Start\nConfigure location - Set your city/coordinates and search radius\nRun search - Find gas stations and estimated prices\nSchedule daily alerts - Get morning notifications with cheapest options\nFocus on Costco - Costco typically has gas $0.15-0.25 below market average\nWorkflow\nStep 1: Configure Your Location\n\nOption A: Use ZIP code (recommended)\n\n# Search by ZIP code\npython3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary\n\n\nOption B: Use coordinates\n\nDefault locations are pre-configured for Columbus, Ohio:\n\n# Columbus, OH (downtown)\nlat: 39.9612\nlon: -82.9988\nradius: 20 miles\n\n\nTo use a different location:\n\npython3 scripts/gas_alternative.py --lat <latitude> --lon <longitude> --radius <miles>\n\n\nCommon US cities:\n\nColumbus, OH: 39.9612, -82.9988\nChicago, IL: 41.8781, -87.6298\nNew York, NY: 40.7128, -74.0060\nLos Angeles, CA: 34.0522, -118.2437\nMiami, FL: 25.7617, -80.1918\nStep 2: Search for Gas Stations\n# Search with summary output\npython3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --summary\n\n# Save to file\npython3 scripts/gas_alternative.py --lat 39.9612 --lon -82.9988 --radius 20 --fuel 87 --output gas_prices.json\n\n\nParameters:\n\n--zip: ZIP code (overrides lat/lon, e.g., --zip 43215)\n--lat: Latitude (default: 39.9612 - Columbus, OH)\n--lon: Longitude (default: -82.9988 - Columbus, OH)\n--radius: Search radius in miles (default: 20)\n--fuel: Fuel type - 87, 89, 91, diesel (default: 87)\n--base-price: Base price for estimation (default: 2.89)\n--output: Output file (default: gas_prices.json)\n--summary: Print human-readable summary to stdout\nStep 3: Set Up Daily Alerts\n\nUse OpenClaw cron to receive daily morning notifications:\n\n{\n  \"name\": \"Gas price alert\",\n  \"schedule\": {\n    \"kind\": \"cron\",\n    \"expr\": \"0 8 * * *\",\n    \"tz\": \"America/New_York\"\n  },\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"Get me gas prices for Columbus, OH this morning. Focus on Costco and show the cheapest 87 octane within 20 miles of downtown.\"\n  },\n  \"sessionTarget\": \"main\"\n}\n\n\nThis runs every day at 8 AM Eastern Time.\n\nStep 4: Receive Notifications\n\nThe agent will:\n\nSearch for gas stations in your area\nIdentify Costco and discount stations\nGenerate a summary with the cheapest options\nSend the summary via Telegram\n\nExample notification:\n\n⛽ Gas Prices (87 Octane) - Columbus, OH\n\n🏠 Costco (Typically Cheapest)\n• Costco Gas\n  💰 $2.69 (est.)\n  📍 5000 Morse Rd, Columbus, OH 43213 (7.9 miles from downtown)\n\n💡 Tip: Costco typically has gas $0.15-0.25 below market average.\n\nOutput Format\n\nEach station includes:\n\n{\n  \"source\": \"osm\",\n  \"name\": \"Costco Gas\",\n  \"brand\": \"Costco\",\n  \"address\": \"5000 Morse Rd, Columbus, OH 43213\",\n  \"lat\": 39.9667,\n  \"lon\": -82.8500,\n  \"distance\": 7.9,\n  \"fuel_type\": \"87\",\n  \"price\": 2.69,\n  \"price_text\": \"$2.69 (est.)\",\n  \"is_costco\": true,\n  \"scraped_at\": \"2026-02-10T21:00:00.000Z\"\n}\n\nHow It Works\nOpenStreetMap/Overpass API - Finds all gas stations in the area\nCostco database - Known Costco locations are matched and prioritized\nPrice estimation - Costco prices estimated $0.15-0.25 below market average\nDistance calculation - Uses geodesic distance for accurate mileage\nSmart filtering - Removes duplicates and sorts by relevance\nLimitations\nReal-time prices: Currently uses estimated prices for Costco. For exact prices, check GasBuddy.com or station apps.\nCoverage: Relies on OpenStreetMap data completeness\nEstimation accuracy: Costco prices estimated based on typical discount patterns\nFor Real-Time Prices\n\nTo get actual real-time prices:\n\nGasBuddy.com - Check manually or use their commercial API\nStation apps - Costco, Kroger, Shell, etc., have apps with current prices\nAAA - Provides average prices by region\nWaze - Community-sourced price updates\nTroubleshooting\nNo stations found\nIncrease the --radius parameter\nVerify coordinates are correct\nCheck if the area has good OpenStreetMap coverage\nIncorrect prices\nPrices for non-Costco stations are estimated as \"N/A\"\nCostco prices are estimates based on typical discount patterns\nFor exact prices, use GasBuddy or the station's app\nGeopy not installed\npip install geopy\n\nResources\nscripts/gas_alternative.py\n\nMain script for searching gas stations using OpenStreetMap and Overpass API.\n\nFeatures:\n\nFinds all gas stations within radius\nIdentifies Costco locations\nEstimates Costco prices\nCalculates distances\nGenerates human-readable summaries\nscripts/gasbuddy_search.py\n\nAlternative script for GasBuddy integration (requires Playwright or API key).\n\nUse when:\n\nYou have a GasBuddy API key\nYou need real-time prices\nYou're willing to use Playwright for JavaScript rendering\nreferences/locations.md\n\nCoordinates and configurations for common US cities.\n\nDependencies\n\nInstall required packages:\n\npip install requests geopy\n\n\nFor Playwright-based GasBuddy scraping (optional):\n\npip install playwright\nplaywright install"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/GustavoZiaugra/test-gas-skill",
    "publisherUrl": "https://clawhub.ai/GustavoZiaugra/test-gas-skill",
    "owner": "GustavoZiaugra",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/test-gas-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/test-gas-skill",
    "agentUrl": "https://openagent3.xyz/skills/test-gas-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/test-gas-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/test-gas-skill/agent.md"
  }
}