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