> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 템플릿 검색

> Octoparse 수집 템플릿을 검색하고 executeTask 실행 전에 입력 스키마를 확인합니다.

<Info>요청 빌더, cURL 예제 및 응답 스키마는 API 패널의 OpenAPI 정의에서 생성됩니다. 워크플로 안내와 AgentTools 관련 규칙은 이 페이지를 참고하세요.</Info>

클라이언트에서 실행할 템플릿을 아직 모를 때 Octoparse 수집 템플릿을 검색합니다.

<Steps>
  <Step title="후보 템플릿 검색">`keyword`, `id`, `slug`, `limitIds` 또는 `tags`를 사용해 템플릿 목록을 좁힙니다.</Step>
  <Step title="권장 템플릿 확인">`response.data`에서 `recommendedTemplateName`, `inputSchema`, `sourceTree`, `sourceSummary`, `outputSchema`를 확인합니다.</Step>
  <Step title="executeTask 준비">각 `inputSchema.field` 값을 `executeTask`의 안정적인 매개변수 키로 사용합니다.</Step>
</Steps>

```text theme={null}
searchTemplates -> executeTask -> exportData
```

<CardGroup cols={2}>
  <Card title="인증" icon="key">`x-api-key`를 사용하는 것이 좋습니다. `x-client`와 `accept-language`는 선택 사항입니다.</Card>
  <Card title="비즈니스 데이터" icon="braces">비즈니스 필드는 `response.data`에서 읽으세요. `requestId`는 문제 해결에만 사용합니다.</Card>
</CardGroup>

<Warning>소스 기반 필드의 경우 클라이언트는 표시 레이블이 아니라 옵션 키를 `executeTask`에 전달해야 합니다.</Warning>

<AccordionGroup>
  <Accordion title="중요 응답 필드">
    `recommendedTemplateName`은 `executeTask`에 전달할 가장 적합한 템플릿 이름입니다.

    `templates`에는 일치하는 템플릿과 해당 메타데이터가 포함됩니다.

    `inputSchema`는 권장 템플릿의 입력을 설명합니다. `field`를 매개변수 키로 사용하세요.

    템플릿에서 선택이 필요한 경우 `sourceTree`와 `sourceSummary`가 소스 기반 옵션을 설명합니다.

    `outputSchema`는 예상 출력 필드를 설명합니다.
  </Accordion>

  <Accordion title="다음 호출">`executeTask` 호출 여부를 결정할 때 `suggestedNextCall`, `workflow`, `toolHint`를 따르세요.</Accordion>
</AccordionGroup>
