miantiao-me/Sink

어떤 프로젝트인가요?

핵심 기능

• 01사용자 지정 슬러그와 UTM 매개변수를 사용해 URL을 단축하고, 선택적으로 대소문자를 구분해 일치시킵니다.
• 02링크 만료일과 비밀번호를 설정하고 안전하지 않은 링크 경고 페이지를 표시합니다.
• 03방문자의 기기나 국가에 따라 리디렉션합니다.
• 043D 지구본과 이벤트 로그를 포함한 링크 분석을 보여줍니다.
• 05링크를 JSON으로 가져오고 내보내며, 분석 데이터를 CSV로 내보냅니다.
• 06REST API와 내장 MCP 엔드포인트를 제공합니다.

활용 사례

• 서버를 관리하지 않고 Cloudflare에서 자체 호스팅하는 브랜드 단축 도메인을 운영합니다.
• 마케팅 링크의 클릭 수와 지역별 분포를 추적합니다.
• AI 어시스턴트가 MCP를 통해 프로그래밍 방식으로 단축 링크를 만들고 조회하도록 합니다.

빠른 시작

1. 1

   npx로 AI Skills 설치

   npx skills add miantiao-me/sink
2. 2

   Cloudflare Workers 배포 가이드 읽기(권장)

사용 전 알아둘 점

• !Cloudflare용으로 설계되었습니다. Cloudflare Workers, D1, KV에서만 실행되므로 Cloudflare 계정이 필요합니다.
• !AGPL-3.0 카피레프트 라이선스가 적용됩니다. 네트워크 서비스로 제공하는 경우 수정한 소스 코드를 공유해야 합니다.
• !Cloudflare Pages 배포는 더 이상 권장되지 않습니다. Workers 사용을 권장합니다.

토픽

자주 묻는 질문

Sink은(는) 무엇인가요?

Cloudflare Workers, D1, KV에서 기존 서버 없이 완전히 실행되는, 분석 기능을 갖춘 셀프 호스팅 링크 단축 서비스입니다. Sink는 Nuxt로 만든 URL 단축 및 링크 관리 앱으로, Cloudflare Workers에 배포됩니다. Cloudflare D1을 링크의 기준 저장소로 사용하고 Workers KV를 쓰기 동시 갱신 방식의 읽기 캐시로 활용하며, Workers Analytics Engine에 방문 데이터를 기록해 분석 대시보드에 표시합니다.

Sink은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Sink은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Sink은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Sink의 마지막 커밋은 2026년 9월 27일입니다.

Sink은(는) 어디에 사용할 수 있나요?

서버를 관리하지 않고 Cloudflare에서 자체 호스팅하는 브랜드 단축 도메인을 운영합니다. 마케팅 링크의 클릭 수와 지역별 분포를 추적합니다. AI 어시스턴트가 MCP를 통해 프로그래밍 방식으로 단축 링크를 만들고 조회하도록 합니다.

Sink는 어떻게 설치하나요?

npx로 AI Skills 설치: npx skills add miantiao-me/sink Cloudflare Workers 배포 가이드 읽기(권장)

Sink은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/miantiao-me/Sink