이 20개 도구는 "기능 데모"가 아닙니다. 모든 규칙은 실제 운영 사고에서 나왔습니다——출시 사고, 캐시 사고, cron에 덮어쓰기, AI 크롤러에게 무시당하기, 스스로는 결코 돈을 받을 수 없게 만든 가격 책정. 우리는 "당시 무엇이 틀렸고 최종적으로 어떻게 해결했는지"를 점검 항목과 생성기로 고정해,전부 무료, 로그인 불필요, 입력 내용은 브라우저에서만 계산되며 업로드되지 않습니다。
x402 데이터 연동을 "기업이 스스로 끝낼 수 있는" 일로 만들고 싶습니다. 도구는 무료, 연동도 무료, 홍보도 무료입니다. 기업이 감당하기 어려워 운영 대행과 등록 대행이 필요할 때만 비용을 받습니다 (Managed / Enterprise). 이미 잘하는 기업이 남는 이유는플랫폼이 그들에게 가져다주는 배포와 정산 물량이며, 그 부분은 성사에 기여한 가치 기준으로 수수료를 받고 월 이용료는 받지 않습니다.
이 표는 저희 자체 사고 장부입니다. 겪고 있는 문제도 대부분 여기 있습니다.
| 도구 | 당시 겪은 함정 | 최종적으로 어떻게 해결했는가 |
|---|---|---|
| x402 엔드포인트 점검 | 헬스 체커가 SSE를 반환하는 MCP 엔드포인트를 ‘사망’으로 판정; 커스텀 402 응답 헤더를 브라우저가 읽지 못함 | HTTP 상태 코드 기준으로 판정하도록 변경; 서버에 추가 Access-Control-Expose-Headers |
| 가격·수익 분배 계산기 | 단가를 너무 낮게 책정해 1년 내내 $50 최소 정산 기준에 못 미쳐 돈이 계좌에 묶임 | 등록 전에 계산: 호출량 × 단가 × 분배율로 최소 실행 가능 가격을 역산 |
| llms.txt 생성기 | llms.txt를 마케팅 문구로 쓰면 어떤 AI도 인용하지 않습니다 | 검증 가능한 사실 + 절대 경로 + 명확한 가격·네트워크 파라미터만 기재 |
| AI 크롤러용 robots.txt | CDN/프레임워크 기본 템플릿이 AI 크롤러를 전부 block 해서 GEO가 바로 0이 됨 | AI 크롤러 40종 이상을 하나씩 명시적으로 허용하고, 비공개 경로는 별도로 Disallow |
| JSON-LD 생성기 | Dataset에 license/distribution이 없어 AI가 신뢰하지 않음 | 유형별로 필수 필드를 채우고 생성 전에 로컬 검증 |
| 배포 자체 점검 + nginx 스니펫 | nginx -t 통과했지만 301과 try_files 무한 루프로 사이트 전체가 열리지 않음 | 변경할 때마다 실제 HTTP 요청으로 자체 점검(리다이렉트 횟수 제한 포함), 문법만 보지 않음 |
| cron 생성 사이트 덮어쓰기 방지 가드 | rentgpu.link에서 수동으로 수정한 876개 페이지가 스케줄 작업 한 번으로 전부 덮어써짐 | 생성기 템플릿만 수정 → 재생성 → 배포; 산출물 mtime을 감시하는 가드 스크립트 추가 |
| 정적 리소스 버전 생성기 | 같은 함정을 세 번: CSS/JS를 고쳐도 운영에서는 ‘적용 안 된 것처럼’ 보임 | 장기 캐시에는 반드시 버전 번호를 붙이고, 바꿀 때마다 올려 배포 체크리스트에 적는다 |
| 데이터 소스 연동 마법사 | 수집기가 명시적으로 보내지 않은 것은 Accept-Encoding: identity여서 상대가 gzip을 켜면 파싱이 깨졌습니다; 온체인 로그를 0부터 스캔하면 반드시 실패합니다. | 수집 계층에서 인코딩 고정 + 타임아웃 재시도; 온체인은 체인 헤드에서 2000블록 되돌려 증분 스캔 |
| 무료 할당량 설정기 | IP 기반 속도 제한은 분산 Agent에 전혀 무용지물이며 제한 없는 것과 같음; 무료 쿼터를 너무 크게 주면 장기 수익 0 | 쿼터를 Agent/키 단위로 묶고 일일 서킷 브레이커 적용; 무료 쿼터를 고객 획득 비용으로 보고 ROI 계산 |
| 정산 대사 템플릿 생성기 | 실행 중에 데이터 파일을 직접 수정했더니 서비스 메모리의 옛 값으로 덮어써짐 | 데이터 수정 전 서비스 중지; 대조는 온체인 Transfer 이벤트만 인정, 허용 오차 ±$0.02 |
| 호출 명세 분석기 | 일별 집계를 증분 누적으로 해서 매일 PV가 두 배; 시간을 먼저 포맷하고 시간 창 필터를 걸면 바로 에러 | 일별 재계산 후 덮어써 멱등성 보장; 문자열 변환은 모든 집계 이후에 수행 |
| GEO 인용 모니터링 체크리스트 생성기 | 외부 AI가 수수료를 15%, 정산을 T+7로 적었는데 ‘언급률’ 지표는 초록색이었다 | 모니터링에는 ‘기술 정확도’를 별도 지표로 둬야 한다. 언급됐지만 잘못 설명되면 언급 안 된 것과 같다 |
| 엔드포인트 가용성 대시보드 구성기 | JSON-RPC 클라이언트로 MCP 엔드포인트를 확인하니 SSE 응답이 ‘사망’으로 판정; p.ok 필드 오타로 전부 항상 변동으로 판정 | HTTP 상태 코드로만 판정(200/402 모두 정상으로 간주); 필드명은 쓰기 코드와 대조해 확인 |
| 라우팅·리다이렉트 체인 점검기 | 관리자 주소 /admin 는 301로 /admin/로 넘어갑니다. 실제 디렉터리에 index가 없어 403 흰 화면이 계속되는데도,nginx -t 는 늘 초록불입니다. | 내부 rewrite로 파일에 직접 도달; 수정 후에는 반드시 실제 요청을 보내 상태 코드와 리다이렉트 횟수 확인 |
| 캐시·버전 정책 구성기 | 캐시 설정 expires 7d 로 캐시된 스크립트는 개편 후에도 브라우저에서 옛 버전으로 계속 돌았고, 새 데이터를 렌더링하다 크래시가 났으며, catch가 "서버를 읽을 수 없다"고 거짓 보고했습니다. | 관리자 스크립트만 별도로 no-cache; 오류 문구는 ‘렌더 크래시’와 ‘네트워크 실패’를 구분 |
| MCP 서버 배포 자체 점검기 | 같은 버전 번호로 다시 게시하면 거부됩니다; TXT 레코드를 _mcp-auth 셀렉터 아래에 두면 일반화된 서명 오류가 납니다. | 버전은 매번 +1; TXT는 도메인 루트 apex에 배치; 배포는 PR이 아니라 CLI 사용 |
| 오류 폴백·성능 저하 코드 생성기 | 렌더 크래시가 catch에 의해 ‘서버 데이터 읽기 실패’로 분류되어 서버를 이틀간 조사했지만 전부 200이었다 | 조회와 렌더링의 try를 분리; 네 가지 실패에 네 가지 메시지; 실패 시 localStorage로 폴백 |
| x402 엔드투엔드 연동 체크리스트 | 402 응답 헤더를 보냈지만 JS가 읽지 못함; 금액을 1e16으로 작성해 facilitator가 거부 | 커스텀 응답 헤더 노출; 소수점 6자리로 환산; 대조는 온체인 Transfer만 인정 |
| 접근 로그 인사이트 | 크롤러를 사람으로 집계해 PV가 두 배; 일별 증분 누적으로 중복 집계 발생 | UA 기준으로 사람/AI/검색/도구 4종으로 분류; 일별 재계산 후 덮어써 멱등성 보장 |
스스로 할 수 있으면 도구를 쓰세요. 안 될 때는 저희가 등록, 홍보, 정산을 대행합니다.