인스피레이션 레퍼런스
브리프를 짧고 정직한 실제 레퍼런스 세트로 전환하세요. 라이브러리를 검색하고, 실제 이미지를 살펴보고, 각각이 브리프에 어떻게 부합하는지 설명하고, 사용자가 범위를 좁힐 수 있도록 도와주세요. 좋은 답변은 사용자가 바로 활용할 수 있는 4~6개의 레퍼런스로, 12개의 링크를 던져주는 것이 아닙니다.
사용 시기
- "인스피레이션 찾아줘", "좋은 가격 페이지 보여줘", "훌륭한 온보딩 플로우는 어떤 모습이지?", "핀테크 히어로 섹션 참고 자료", "무드보드 만들어 줘", "이거랑 비슷한 거", "이 두 개 비교해 줘", "보드에 저장해 줘", "내 보드에는 뭐가 있지?", "내 X 북마크 검색해 줘" 같은 요청.
- 사용자가 "인스피레이션"이라고 말하지 않더라도 디자인 패턴의 실제 예시를 원할 때도 사용합니다.
- 페이지를 디자인하고 구축할 때는 사용하지 마세요(
inspiration-art-direction사용), 팔레트나 폰트 키트(inspiration-brand-kit사용), 또는 레퍼런스 질문 없이 코드 변경을 할 때는 사용하지 마세요.
도구는 여기서는 기본 이름(search_inspiration)으로 표시됩니다. 클라이언트에서는 mcp__plugin_inspiration_inspiration__(Claude Code 플러그인 설치), mcp__inspiration__ 또는 커넥터 이름과 같은 서버 접두사가 붙습니다.
1. 설정 확인
어떤 접두사가 붙었든 search_inspiration이라는 도구를 찾으세요. 호스트가 도구를 지연 로딩하는 경우, 호스트의 도구 검색을 통해 로드하면 사용 가능한 것으로 간주합니다. 도구가 없으면 references/setup.md를 읽고 사용자에게 해당 클라이언트에 맞는 한 단계 안내를 제공한 후 중단하세요. 사용자가 그래도 계속하기를 원하면, 라이브러리 레퍼런스를 보여줄 수 없다는 점을 솔직히 알리고 자신의 지식을 바탕으로 일반적인 안내를 제공하세요. ID, 제목, 이미지 URL, 설명을 절대 임의로 만들지 마세요.
2. 브리프 해석
네 가지 요소를 추출하세요. 무엇(카테고리와 하위 유형), 모양(스타일, 색상, 테마, 타이포그래피), 느낌(분위기), 맥락(산업). 구체적이고 시각적인 용어는 query에 넣고, 명확한 제약 조건만 filters에 넣으세요.
search_inspiration(
query="중간 티어가 강조된 다크 모드 SaaS 가격 페이지",
category="website-sections",
filters={"subtype": ["pricing", "pricing-table"], "theme": ["dark"]},
limit=6)
filters는 키 간에는 AND, 키 내에서는 any-of(OR)로 적용됩니다. 보통 1~3개의 키가 적절하며, 키가 너무 많으면 결과가 거의 나오지 않습니다.subtype는 website-sections의 경우 섹션 유형(hero,pricing,cta,footer...), slide-decks의 경우 슬라이드 역할(cover,traction,the-ask...), 그 외의 경우 자산 유형(logo,poster,dashboard...)을 의미합니다. 카테고리별 값과 레시피는references/search-recipes.md를 참조하세요.- 브리프가 모호하거나 값이 확실하지 않으면
list_facets(category=..., top=25)를 호출하세요. 이 호출은 미터링되지 않습니다. 오류가 발생하면references/search-recipes.md의 값을filters에 계속 사용하고, 해당 검색 결과가 0개일 때만 필터를 하나 제거하세요. - 사용자가 원하는 브랜드의 룩을 지정하면
brand="<website-styles slug>"를 전달하여 결과를 해당 브랜드 쪽으로 재정렬하거나, 프로필 딕셔너리(palette,style,mood,typography,industry,tags,theme)를 전달하세요. - 결과가 0개이면
suggestions가 반환됩니다. 제안 중 하나를 사용하거나 필터 하나를 제거하여 한 번 재시도하고, 무엇을 완화했는지 사용자에게 알려주세요.
전체 세트가 한 번의 이미지 호출에 맞도록 limit=6을 사용하세요. limit=1은 "하나만 보여줘" 요청에 사용되며 alternates를 추가합니다.
3. 말하기 전에 먼저 보기
검색은 URL과 메타데이터를 반환하며, 픽셀 데이터는 반환하지 않습니다. ID 목록(최대 6개)을 사용하여 get_image를 한 번 호출하고, 각 레퍼런스에 대해 쓰기 전에 모든 이미지를 살펴보세요.
각 레퍼런스에 대해 다음을 제공하세요:
- ID와 제목(ID는 보드와 후속 작업에서 사용됩니다).
- 브리프에 맞게 실제로 하는 역할을 이미지에서 한두 줄로 설명: 레이아웃, 계층, 글자체 처리, 색상 비율, 주목할 만한 세부 사항.
- 일치 라벨: 완전히 일치하지 않는 경우 "부분 일치: 다크하고 에디토리얼 스타일이지만 강조된 티어는 없음"과 같이 표시. 정직한 라벨이 목록을 부풀리는 것보다 낫습니다.
그런 다음 두세 줄의 종합을 추가하세요: 강력한 레퍼런스들이 공유하는 패턴, 그리고 어떤 레퍼런스를 시작점으로 삼을지와 그 이유. 이미지가 확인해 주지 않는 한 제목, 태그, 필터 일치 항목을 설명에 포함하지 마세요. theme: dark 필터를 통과한 결과라도 밝은 페이지일 수 있으므로 부분 일치로 표시하세요. 보이는 것만 설명하세요: 모션, 호버 상태, 스크롤 효과는 정지 이미지에서 볼 수 없습니다.
4. 더 보기, 좁히기, 또는 유사 항목 찾기
- 동일 검색 더 보기:
exclude_ids=[이미 표시된 ids](권장) 또는offset=6을 사용하여 반복하세요. 먼저has_more를 확인하세요. - 이것과 비슷한 항목:
similar_items(id, limit=6)를 사용하거나, 같은 호출에서 시드의 패싯도 필요하면get_inspiration(id, similar=6)를 사용하세요. - 이것과 비슷하지만 변경된 경우("더 밝게", "더 장난기 있게", "핀테크용"): 시드의 패싯(
get_inspiration(id))을 읽고 시드 이미지를 살펴본 후, 시드의 하위 유형과 변경된 제약 조건을 필터 또는 쿼리 단어로 사용하여 시드를 제외하고 검색하세요.get_inspiration이 오류를 반환하면, 일반search_inspiration(query="<slug의 단어>", category="<시드 카테고리>", limit=3)(verbose나brand없이)으로 시드의 행을 찾고,image_url을 열어 픽셀에서 모양을 확인하세요. 시드와 비교하여 변경된 사항을 기록하세요. - 일부 항목의 세부 정보: 한 번의 호출로
get_inspiration([ids], detail="standard")를 사용하세요.detail="full"은 크기가 크므로 필요한 필드가 누락된 경우에만 사용하세요.
5. 레퍼런스 비교
사용자가 어떤 것이 더 나은지 또는 어떻게 다른지 물을 때, 이미 가져온 이미지(누락된 것은 한 번에 가져오기)에서 후보들을 나란히 배치하세요:
| 참고 A | 참고 B | |
|---|---|---|
| 계층 구조 | ||
| 글자체 | ||
| 색상과 대비 | ||
| 밀도와 간격 | ||
| 가져갈 점 |
사용자의 브리프에 연결된 추천과 각 레퍼런스에서 버려야 할 점으로 마무리하세요. 원칙을 가져가고 픽셀을 가져오지 마세요. 로고, 카피, 이미지, 라이선스가 있는 서체를 복사하도록 제안하지 마세요.
6. 보드
보드는 사용자의 인스피레이션 계정(inspiration.vasa.works)에 저장됩니다.
- 명시적인 요청이나 사용자의 동의가 있을 때만 쓰기 작업을 수행하세요. 결과 검색, 보기, 좋아요는 허가가 아닙니다. 결과를 보여준 후 한 번 제안하세요: "이것들을 보드에 저장할까요?"
save_to_board(title, ids=[...])는 보드를 생성하거나, 해당 제목의 보드가 이미 있으면 항목을 추가합니다.board_url,item_count,added,already_in_board를 반환합니다. URL을 공유하세요.save_to_board(title, query=..., filters=..., category=..., limit=...)는 한 번의 호출로 검색과 저장을 수행합니다. 사용자가 검토 없이 "찾는 대로 저장"해 달라고 요청한 경우에만 사용하세요.list_my_boards()는 "내 보드" 목록을 표시합니다.get_board(board)(ID 또는 슬러그)로 특정 보드를 보여주고, 사용자가 이미지를 보고 싶어하면 최대 6개의 항목 ID에 대해get_image를 호출하세요.add_to_board(board, item_ids)는 특정 기존 보드에 항목을 추가합니다.create_board(title, item_ids)는 비어 있거나 시드가 있는 새 보드를 생성합니다.- 오류:
board_limit또는item_limit(사용자에게 알리고 기존 보드를 제안),rate_limited(대기 후 한 번 재시도),nothing_to_save(ID 전달).
7. 사용자의 X 북마크
사용자가 자신의 북마크나 저장된 게시물을 언급하면 search_x_bookmarks(query, limit=10)를 호출하세요. 이는 가져온 북마크만 검색합니다. "status": "not_connected" 결과에는 connect_url이 포함되며 이를 전달하세요. 결과에는 트윗 텍스트, 이미지 URL, 게시물 링크가 포함됩니다. 이미지를 실제로 볼 수 있었던 경우에만 설명하고, 그렇지 않으면 저장된 텍스트를 인용하고 이미지를 보지 못했다고 말하세요.
예산
무료 계정은 UTC 월별로 50회의 미터링된 호출이 허용됩니다. 일반적인 요청은 3~5회의 호출이 소요됩니다:
| 단계 | 호출 수 |
|---|---|
| list_facets (모호한 경우에만) | 0, 미터링되지 않음 |
| search_inspiration | 1 (재시도 포함 2) |
| get_image, 최대 6개 ID의 한 배치 | 1 |
| 한 번의 후속 작업 (더 보기, 유사, 비교, 저장) | 1 또는 2 |
모든 것을 배치 처리하세요: get_image는 최대 6개의 ID를 받고, get_inspiration은 목록을 받습니다. 항목당 한 번씩 호출을 반복하지 마세요.
할당량 및 오류
도구가 오류(quota_exhausted, capped)를 반환하거나 get_image가 실패할 때(공개 image_url을 통한 이미지 대체 수단이 있으며 미터링 호출이 아님) 처음으로 references/library-rules.md를 읽으세요. 간단히 설명하면: quota_exhausted는 모든 미터링 호출을 중단하고(링크 https://inspiration.vasa.works/pricing, 가지고 있는 것으로 마무리), capped는 더 이상 페이지가 없음을 의미하며, not_found는 재검색을 의미하고(ID를 절대 추측하지 마세요), subscription_required는 로그인을 의미하며, 두 개의 다른 도구에서 동일한 서버 오류가 발생하면 저하된 모드를 의미합니다. 오류가 발생한 호출도 예산에 포함됩니다. 보드 오류는 섹션 6에 나와 있습니다.
규칙
- 충실성. 실제로 열어본 이미지(
get_image또는image_url대체 수단)에서 본 것만 설명하세요. 제목만으로 세부 사항을 주장하지 마세요. - 원칙, 픽셀이 아닙니다. 레퍼런스는 참고 자료일 뿐이며, 복사할 템플릿이 아닙니다.
- 라이브러리 이름만 명시하세요. 인스피레이션 라이브러리 또는 VASA.Works의 Inspiration이라고 부르세요. 항목의 출처를 추측하지 마세요. 타사 사이트를 항목의 출처로 링크하지 마세요. 글꼴 파운드리 또는 라이선스 페이지, 사용자 자신의 북마크 게시물 링크, 보드 URL은 괜찮습니다.
- 무음 보드 쓰기 금지.