API 키 발급하고 마이리얼트립 마이링크 만들기

이전 글에서 마이리얼트립 MCP로 상품 후보를 검색했으니, 이번에는 그 상품 URL을 제휴 링크로 바꿉니다. 마이리얼트립 마케팅 파트너에서는 마이링크를 만들 수 있고, API를 쓰면 myrealt.rip 형태의 단축 링크도 생성할 수 있습니다.

이 단계부터는 API 키를 다루므로 보안에 주의해야 합니다.

API 키 발급받기 — 안전한 보관까지가 발급입니다

먼저 마이리얼트립 마케팅 파트너 계정이 필요합니다. 파트너 페이지(partner.myrealtrip.com)에 로그인한 뒤 Open API → API Key 발급 메뉴에서 키를 발급받습니다.

API 키는 비밀번호와 같아서 한 번 노출되면 되돌릴 수 없습니다. 화면 캡처나 공개 게시물에 키가 보이지 않게 하고, GitHub에 커밋하지 않으며, 실수로 노출했다면 바로 재발급합니다.

그래서 키는 명령어나 코드에 직접 적지 않고, 작업 폴더에 .env 파일을 만들어 저장합니다.

MRT_API_KEY=발급받은_API_KEY

.env는 내 컴퓨터에만 두는 파일입니다. GitHub처럼 공개된 곳에 코드를 올린다면 .gitignore에 추가하고, 공유가 필요하면 키 값을 비운 .env.example만 올립니다.

이렇게 해두면 IDE에서 Claude에게 작업을 시킬 때도 "API 키는 .env에 있어"라고 알려주기만 하면 됩니다. 대화나 코드에 키를 붙여 넣을 일이 없어집니다.

상품 URL 준비 — ID 체계 함정 하나

MCP에서 가져온 투어·액티비티 상품은 https://experiences.myrealtrip.com/products/5855431 형태의 URL을 사용합니다.

여기서 주의할 함정이 하나 있습니다. MCP 검색 결과의 product_id를 https://www.myrealtrip.com/offers/{id}에 넣으면 오류가 나는데, offers/{id}는 마케팅 파트너 검색 API가 주는 별도의 itemId 체계를 쓰는 경로이기 때문입니다. MCP에서 가져온 상품은 반드시 experiences.myrealtrip.com/products/{id} 형태를 씁니다.

utm_content 나누고 마이링크 만들기

제휴 링크 하나를 모든 곳에 붙이면 어떤 글이나 SNS 포스트가 성과를 냈는지 알 수 없습니다. 그래서 발행 위치별로 utm_content를 나눕니다.

발행 위치	utm_content
블로그 상단	velog-top
블로그 중간	velog-mid
블로그 하단	velog-bottom
Threads 첫 번째 글	threads-a
Threads 두 번째 글	threads-b
Instagram 프로필 링크	instagram-bio

예를 들어 같은 상품이라도 블로그 상단 링크와 Threads 링크는 다르게 만듭니다.

https://experiences.myrealtrip.com/products/5855431?utm_content=velog-top
https://experiences.myrealtrip.com/products/5855431?utm_content=threads-a

마이링크 생성 API는 대상 URL을 넘기면 단축 링크를 돌려줍니다. IDE에서 Claude에게 ".env의 키로 마이링크 만들어줘"라고 시키면 아래 호출을 대신 해주고, 직접 실행한다면 이런 형태입니다.

curl -s https://partner-ext-api.myrealtrip.com/v1/mylink \
  -H "Authorization: Bearer $MRT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"targetUrl": "https://experiences.myrealtrip.com/products/5855431?utm_content=velog-top"}'

정상이라면 응답의 data 필드에 myrealt.rip 형태의 단축 링크가 들어 있고, 블로그 중간·Threads·Instagram 링크도 같은 방식으로 만들면 됩니다.

{
  "targetUrl": "https://experiences.myrealtrip.com/products/5855431?utm_content=velog-top",
  "mylink": "https://myrealt.rip/abc123",
  "mylinkId": 123456
}

아래는 같은 상품에 utm_content를 다르게 붙여 발행 위치별 마이링크를 여러 개 만든 예시입니다.

링크맵으로 보관하기

생성한 링크는 글에 바로 붙이기 전에 링크맵으로 정리해둡니다. 나중에 성과 데이터에서 utm_content가 보였을 때 어떤 콘텐츠 위치에서 발생한 예약인지 바로 찾기 위해서입니다.

{
  "content_id": "berlin-half-day-course-2026-07",
  "product_id": "5855431",
  "links": {
    "velog_top": {"utm_content": "velog-top", "short_url": "https://myrealt.rip/abc123"},
    "velog_mid": {"utm_content": "velog-mid", "short_url": "https://myrealt.rip/def456"},
    "threads_a": {"utm_content": "threads-a", "short_url": "https://myrealt.rip/ghi789"},
    "instagram_bio": {"utm_content": "instagram-bio", "short_url": "https://myrealt.rip/jkl012"}
  }
}

다음 단계

이제 상품 데이터와 제휴 링크가 준비되었습니다. 다음 글에서는 이 재료를 바탕으로 블로그 글, Threads 포스트, Instagram 후보, 링크맵, 고지 문구, 발행 체크리스트를 하나의 발행 패키지로 묶습니다.