为什么值得关注

它通过要求担保人提供真实身份来建立信任，并为开发者提供无需 API 密钥或速率限制的代理原生访问方式，是一个独特、社区驱动且对开发者友好的数据源。

适合谁使用

寻找可靠韩国餐厅推荐的美食爱好者
构建餐饮应用或旅行助手的开发者和 AI 代理
希望公开分享其可信餐厅列表的贡献者
利用开放许可数据分析韩国餐饮趋势的数据科学家

典型使用场景

通过 CLI 或直接 JSON 端点按城市、菜系或价格区间查询餐厅
将经过认证的韩国餐厅数据集成到聊天机器人、地图应用或旅行规划器中
通过 GitHub 问题提交新餐厅或导入现有的地图收藏列表
从 YAML 数据仓库分析餐饮模式和担保网络

项目优势

每个餐厅条目至少有 1 名 GitHub 用户担保，确保责任感和信任度
数据采用 CC BY 4.0 许可证免费提供（包括商业用途），无需 API 密钥
通过 GitHub 问题贡献非常简单，可自动生成 PR，降低了非开发者的参与门槛
代理原生设计提供 JSON 和 JSONL 格式，适合 LLM 上下文和直接查询

使用前须知

目前仅限韩国餐厅，无全球覆盖
数据可靠性依赖志愿贡献者，营业时间、地址或价格可能存在空白
缺少用户评分或评论聚合，仅提供担保人的简短理由

README 快速开始

openribbon · 오픈리본

맛잘알들이 직접 보증한 대한민국 맛집 오픈 데이터베이스

누구나 읽고, 누구나 쓰고, 에이전트가 바로 질의할 수 있는 맛집 리스트.

뭐하는 프로젝트인가

맛집 정보는 널려 있지만, 믿을 수 있는 맛집 정보는 없습니다. 광고와 협찬과 어뷰징 리뷰 사이에서 진짜를 골라내는 건 결국 사람입니다.

openribbon은 맛잘알이 자기 GitHub 계정을 걸고 보증한 맛집만 모읍니다.

모든 항목에 보증인(vouched_by)이 최소 1명 있어야 합니다. 익명 제보는 받지 않습니다.
모든 항목에 한 줄 이유(why) 가 붙습니다. 별점은 없습니다.
데이터는 YAML 파일 하나 = 맛집 하나. Git 히스토리가 곧 신뢰의 기록입니다.
기여는 GitHub 이슈 하나로 끝납니다 (딸깍). 로컬 세팅 필요 없음.

🤖 에이전트 / 개발자용 (agent-native)

빌드된 인덱스를 바로 가져다 쓰세요. 회원가입도, API 키도, 레이트 리밋도 없습니다.

# 전체 데이터 (사람이 읽기 좋은 pretty JSON)
curl -sL https://raw.githubusercontent.com/NomaDamas/openribbon/main/dist/openribbon.json

# LLM 컨텍스트에 넣기 좋은 JSONL (한 줄 = 한 맛집)
curl -sL https://raw.githubusercontent.com/NomaDamas/openribbon/main/dist/openribbon.jsonl

# 에이전트용 사용 설명서
curl -sL https://raw.githubusercontent.com/NomaDamas/openribbon/main/llms.txt

# jq 한 줄로 질의
curl -sL .../dist/openribbon.json | jq '.restaurants[] | select(.city=="서울" and (.cuisine|index("noodle"))) | .name'

CLI로 검색하기:

git clone https://github.com/NomaDamas/openribbon && cd openribbon && bun install

bun run query -- --city 서울 --cuisine korean      # 서울 한식
bun run query -- --q 평양냉면                        # 자유 검색
bun run query -- --price ₩ --json                   # 가성비, JSON 출력
bun run query -- --vouched-by vkehfdl1              # 특정 맛잘알의 리스트

bun run dedupe                                      # 중복 맛집 검사
bun run dedupe -- --fix                             # 중복 자동 병합

📦 데이터 형식

data/restaurants/.yaml 파일 하나가 맛집 하나입니다.

id: woolaeoak-jung              # kebab-case 슬러그, 파일명과 동일해야 함
name: 우래옥
name_en: Woo Lae Oak            # 선택
city: 서울
district: 중구                   # 선택
address: 서울 중구 창경궁로 62-29
cuisine: [korean, noodle]        # korean/chinese/japanese/western/... (schema.ts 참고)
signature:                       # 대표 메뉴 1~6개
  - 평양냉면
  - 불고기
price_range: "₩₩₩"              # ₩(~1만) ₩₩(~3만) ₩₩₩(~7만) ₩₩₩₩(그 이상)
why: 1946년부터 이어온 평양냉면의 기준점. 고기 육수의 단맛과 감칠맛이 또렷하다.
hours: "11:30-21:00"            # 선택
closed_on: 월요일                 # 선택
reservation: walk-in            # required/recommended/walk-in/unknown
tags: [노포, 평양냉면]            # 선택
vouched_by:                      # 필수, 최소 1명
  - handle: vkehfdl1

项目描述

맛잘알들이 GitHub 계정을 걸고 보증한 대한민국 맛집 오픈 데이터베이스. Agent-native, CC BY 4.0.

openribbon