Claude Code 활용 쿠팡 파트너스 자동 링크 삽입기 구축
블로그 포스팅마다 어울리는 상품 링크를 배치하는 번거로움 해결하기
블로그 운영으로 제휴 수익을 거두는 과정에서 관련 상품 링크를 수작업으로 배치하는 일은 상당한 번거로움을 동반합니다. 유익한 정보성 글을 작성한 뒤 본문 맥락에 부합하는 상품을 일일이 검색하여 매칭하려면 많은 시간이 소요되곤 하죠. 이러한 비효율을 개선하고자 인공지능을 결합한 자동 수정 기술을 도입하면 창작 자체에만 온전히 집중하는 환경을 만들 수 있습니다.
터미널 환경에서 작동하는 Claude Code CLI 도구는 복잡한 프로그래밍 지식 없이도 맞춤형 자동화 엔진을 만드는 데 유용하게 쓰입니다. 텍스트 창에 일상적인 대화체로 요구사항을 적기만 하면 인공지능 비서가 알아서 소스코드를 가다듬어 주기 때문이죠. 여기서는 Claude Code CLI와 파이썬 언어를 조화시켜 본문 안의 특정 상품명을 감지하고 자동으로 제휴 링크를 삽입해 주는 AI 에이전트 기초 뼈대를 설계하는 과정을 상세히 다루겠습니다.
검색 포털 노출 제한을 예방하는 안전 규칙과 자동화의 기본 설계
자동으로 포스팅 내부에 쇼핑 링크를 심을 때 가장 주의할 부분은 검색 포털의 검색 제한 제재, 일명 저품질 현상으로 알려져 있습니다. 검색 수집봇은 원고의 맥락과 동떨어진 무분별한 링크가 가득하거나 스팸으로 의심되는 정형화된 패턴을 감지하면 즉시 노출 가중치를 하락시키는 경향이 있죠. 따라서 무조건적인 치환 방식보다는 정밀한 제약 필터를 함께 설계하는 방향이 훨씬 현명합니다.
이번에 제작하는 프로그램은 두 가지 핵심 안전장치를 기반으로 움직입니다. 본문 전체에서 가장 연관성이 높은 키워드를 최대 2개까지만 골라 링크를 심는 빈도 제어 규칙이 대표적이죠. 다음으로는 본문 하단에 반드시 기재해야 하는 공정거래위원회 대가성 고지 문구를 누락 없이 덧붙여 주는 단계로 요약됩니다. 이 모든 처리를 별도 라이브러리 설치 없이 파이썬 기본 패키지로만 구현하여, 성능 부담이 없고 가벼운 무인 파이프라인을 완성하는 것이 주된 목표라 하겠습니다.
폴더 생성 후 개발 비서를 활용하여 스크립트 기초 설계하기
작업을 실행하기 위해 전용 폴더를 만들고 터미널 창에서 작업 도구를 구동해 볼 단계입니다. 인공지능 코더에게 만들고자 하는 파일의 구체적 의도를 일러준다면 복잡하게 구조를 잡는 초반 설계 과정을 대신 완수해 주기 마련이죠.
로컬 시스템의 명령 프롬프트나 터미널 화면을 열어 프로젝트 디렉토리를 생성하고 인공지능 환경을 활성화해 줍니다.
도구가 구동되면 터미널 창에 해결하고자 하는 요구사항을 구체적으로 입력합니다. 예컨대 "블로그 글 원본 파일(draft.txt)을 읽어와 그 안에 들어 있는 '노트북 거치대', '기계식 키보드' 등의 상품 키워드를 포착하여 알맞은 링크로 매치하는 파이썬 코드를 내장 라이브러리로만 구성해 줘"라고 작성하는 형태죠. 이를 인식한 비서는 작업 대상 디렉토리 안에 안정적으로 구동되는 소스코드를 생성하여 답을 냅니다.
파이썬 스크립트 빌드 및 자동 치환 매커니즘 구현
AI 에이전트가 어떤 방식으로 입력 문서를 훑고 단어를 가려내어 링크로 바꾸는지 보여주는 내부 소스코드 구조입니다. 외부 패키지에 과도하게 의존하면 환경에 따른 호환성 충돌로 실행이 예기치 않게 멈추는 상황이 발생하기 쉽죠. 이처럼 순수 내장 라이브러리만을 취하여 논리를 구성하는 방식이 구동 면에서 훨씬 안전하다는 사실을 기억해 둡시다.
디렉토리 내에 구축한 스크립트 파일의 세부 흐름입니다. 텍스트를 열어 지정된 키워드를 매핑한 뒤 발견되는 단어를 1회만 지정 형식으로 바꿉니다. 이후에는 중복 변경이나 본문 훼손을 차단하는 안정적인 방식으로 전체 변환 절차가 흘러가게 되죠.
import re
import os
# 매칭할 상품 링크 정의
COUPANG_PRODUCT_MAP = {
"노트북 거치대": "[노트북 거치대](https://link.coupang.com/a/exampleRef1)",
"기계식 키보드": "[기계식 키보드](https://link.coupang.com/a/exampleRef2)",
"듀얼 모니터": "[듀얼 모니터](https://link.coupang.com/a/exampleRef3)"
}
DISCLAIMER_TEXT = "\n\n이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."
def insert_coupang_links(input_file, output_file):
if not os.path.exists(input_file):
print(f"오류: 원고 파일 {input_file}을 찾을 수 없습니다.")
return False
with open(input_file, 'r', encoding='utf-8') as f:
content = f.read()
updated_content = content
replaced_count = 0
# 단어 맵을 돌며 본문에 해당 키워드가 있으면 링크 형태로 단 1회만 치환
for keyword, link_markdown in COUPANG_PRODUCT_MAP.items():
if keyword in updated_content and replaced_count < 2:
# 중복 치환이나 깨짐을 방지하기 위해 딱 한 번만 교체
updated_content = updated_content.replace(keyword, link_markdown, 1)
replaced_count += 1
print(f"링크 삽입 성공: {keyword} -> 제휴 링크 매칭 완료")
# 대가성 공정위 안내 문구 누락 방지 처리
if DISCLAIMER_TEXT.strip() not in updated_content:
updated_content += DISCLAIMER_TEXT
with open(output_file, 'w', encoding='utf-8') as f:
f.write(updated_content)
print(f"최종 수익화 원고 저장 완료: {output_file}")
return True
if __name__ == '__main__':
# 임시 원고 작성
with open('draft.txt', 'w', encoding='utf-8') as f:
f.write("""최근 집에서 재택근무를 시작하면서 목 통증이 심해졌습니다. 주변에서 노트북 거치대 제품을 추천해 주어 사용해 봤는데 자세 교정에 무척 큰 도움이 되었습니다. 여기에 키감이 편안한 기계식 키보드 세팅까지 곁들이니 능률이 배로 오르네요.""")
insert_coupang_links('draft.txt', 'monetized_post.txt')
이 스크립트는 가상의 초안 원고를 자동으로 구성하고 치환까지 완료하는 자가 작동 모델을 취하고 있습니다. CLI 도구 내에서 해당 파일을 작성한 후 구동을 명하여 정상 변환 여부를 명확히 점검하는 방식이죠. 수정 비교를 제공하는 `/diff` 등의 명령어를 통해 코드의 전후 상태를 대조해 보는 작업 역시 매우 용이해집니다.
프로젝트 설정 문서를 적용한 필터링 지침 규칙 제어
자동 수정 규칙이 앞으로 생성될 다른 초안 파일을 만날 때도 한결같은 품질을 유지하기 위해서는 시스템에 적용되는 명확한 제어 수칙을 확립해 두어야 유용합니다. 프로젝트 최상위 경로에 `CLAUDE.md` 명세서를 세팅해 둘 필요가 여기에 있죠. 이 안내서를 기반으로 삼아 인공지능 비서가 연결 세션마다 어떤 세부 기준으로 결과물을 보정할지 미리 파악하고 움직이도록 제어 규칙을 확실하게 틀에 맞출 수 있습니다.
작업 디렉토리에 다음 규칙을 명시한 설정 파일을 배치하여 작업 강도를 엄격하게 제한해 나갑니다.
- 본문에 링크를 무리하게 심지 말 것. 본문 한 개당 최대 2개만 변경 허용.
- 모든 수정본 하단에는 반드시 쿠팡 파트너스 대가성 고지 문구를 삽입할 것.
- 괄호나 다른 링크 태그 내부의 단어는 교체하지 말 것.
- 실행 및 테스트 명령어: python coupang_linker.py
이 규칙 파일을 마련해 두면 차후 추가적인 가공 지시를 전달할 때마다 매번 같은 경고를 반복해서 적어줄 필요가 사라집니다. 똑똑하게 정돈된 비서가 본문에 필요 이상의 과도한 제휴 정보가 주입되는 실수를 사전에 깔끔하게 방지해 주기 때문이죠.
실시간 연동 시의 고려 사항과 장기 노출 유지 방안
제휴 마케팅 링크 자동화를 수행할 때 실시간 상품 조회 방식으로 확장하는 경우를 고려해 볼 수 있습니다. 다만 이와 같은 방식을 무리하게 가져가면 제한 횟수를 초과하는 예외 상황이 발생하기 쉽죠. 이뿐만 아니라 너무 노골적인 광고 패턴으로 포스팅을 반복하다 보면 도리어 상위 노출에서 누락되는 부작용이 나타나는 일이 다반사입니다. 문맥상 꼭 언급해야 할 품목 중심으로만 텍스트 앵커 방식을 활용해 자연스럽게 배치하는 방향이 훨씬 안정적인 수익 확보에 유익하다는 판단입니다.
터미널 실행을 통한 최종 생성 원고 상태 검사
기초 설계와 가이드라인 세팅이 완비되었다면 이제 셸 명령어로 최종 코드를 구동하고 변경 결과를 파악할 단계입니다. 자동화 지시를 완수한 뒤 최종 텍스트가 설계에 어긋나지 않는 올바른 모양으로 바뀌었는지 눈으로 대조해 보는 것이 안전하겠죠.
터미널 창에 하단 구문을 입력하여 매칭 스크립트를 가동하고, 작업이 끝났다는 출력이 보이면 생성된 텍스트의 내용을 터미널 화면에 호출해 봅니다.
cat monetized_post.txt
정상적으로 변환이 마쳐졌다면 draft.txt 내부 본문의 핵심 문구였던 관련 상품 단어들이 대괄호와 소괄호가 어우러진 마크다운 형식의 링크로 정돈되어 나타납니다. 그리고 글 가장 아랫부분에 공정거래위원회 지침에 의거한 대가성 고지가 이상 없이 이어 붙어 있는 모습을 보게 되죠. 이러한 양식을 갖추고 있다면 자동화 매핑의 모든 설정이 기대한 양상대로 작동했다고 판단할 만합니다.
매번 포스팅 시점마다 상품 페이지에 드나들며 링크를 구워 붙이던 소모적인 흐름을 이처럼 자동화 기법으로 해결할 수 있습니다. 수작업 비율을 줄임으로써 글에 녹아드는 키워드를 선별하는 과정 자체가 한결 단순해지는 성과가 나타나죠. 일련의 빌드 과정을 터미널 안에 구축해 두면, 글 작성이라는 주된 영역에 노력을 쏟으면서도 부가적인 자동화 매칭을 덤으로 챙기는 기틀이 마련되는 법입니다.
이런 글도 있어요
관련 검색어
- 🔍 AI 에이전트 사용법
- 🔍 AI 에이전트 비교
- 🔍 쿠팡 파트너스 사용법
- 🔍 쿠팡 파트너스 비교
- 🔍 블로그 수익화 사용법
- 🔍 블로그 수익화 비교
