k-skill/scripts
Jeffrey (Dongkyu) Kim 397d0eea84 Expose official nearby fuel prices for location-based gas station lookups
Add the first cheap-gas-nearby skill/package pair so nearby gas-price
queries can resolve a user-supplied location, translate it into Opinet's
KATEC search contract, and return the cheapest nearby stations with
address and facility detail. The docs and setup surfaces now advertise
the new skill and its Opinet API key requirement.

Constraint: Nearby fuel prices must come from the official KNOC Opinet API when available
Constraint: No new external dependencies were allowed for coordinate conversion or location resolution
Rejected: Map-only gas price scraping | official Opinet Open API exists and is the preferred source
Rejected: Require lat/lng input only | poorer UX than supporting landmark/station queries through anchor resolution
Confidence: medium
Scope-risk: moderate
Reversibility: clean
Directive: Keep `OPINET_API_KEY` as the only supported official-price credential unless the repo adopts an Opinet proxy later
Tested: npm run ci; node --test packages/cheap-gas-nearby/test/index.test.js; offline fixture smoke via searchCheapGasStationsByLocationQuery('서울역', ...)
Not-tested: Live Opinet API call with a real `OPINET_API_KEY` (no non-placeholder key was configured locally)
Related: #54
2026-04-05 19:46:09 +09:00
..
fixtures Add local air-quality lookup so k-skill covers location-based dust checks 2026-03-27 22:06:19 +09:00
check-setup.sh Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
fine_dust.py Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
korean_spell_check.py Prevent clean spell-check chunks from crashing mixed file runs 2026-04-03 22:29:50 +09:00
ktx_booking.py Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
run-k-skill-proxy.sh Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
sillok_search.py Make joseon-sillok-search installs work outside the repo 2026-04-04 00:15:50 +09:00
skill-docs.test.js Expose official nearby fuel prices for location-based gas station lookups 2026-04-05 19:46:09 +09:00
test_fine_dust.py Make the fine-dust proxy easier to consume than the upstream APIs 2026-03-28 17:14:18 +09:00
test_korean_spell_check.py Prevent clean spell-check chunks from crashing mixed file runs 2026-04-03 22:29:50 +09:00
test_ktx_booking.py Keep waiting-list reservations aligned with the selected train 2026-03-27 11:26:38 +09:00
test_sillok_search.py Restore the sillok CLI's verified stdlib transport fallback 2026-04-04 00:28:58 +09:00
validate-skills.sh Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00