---
title: "DeepSeek Harness용 전사"
description: "transcript.im 플러그인으로 DeepSeek Harness에 공개 영상 전사, YouTube 검색·탐색, 배치 내보내기 도구를 추가하세요."
canonical: "https://transcript.im/ko/deepseek-harness"
markdown: "https://transcript.im/ko/deepseek-harness.md"
---

# DeepSeek Harness용 전사

transcript.im 플러그인으로 DeepSeek Harness에 공개 영상 전사, YouTube 검색·탐색, 배치 내보내기 도구를 추가하세요.

## 모래밭

- [표준 HTML](https://transcript.im/ko/deepseek-harness)
- [Markdown](https://transcript.im/ko/deepseek-harness.md)


DeepSeek Harness 에이전트에 영상 뒤에 있는 원문 텍스트를 제공하세요. transcript.im 플러그인은 전사 가져오기, YouTube 탐색, 배치 도구를 Harness 프로필에 바로 추가하므로, 에이전트가 글을 쓰거나 비교하거나 답하기 전에 근거를 모을 수 있습니다.

- DeepSeek Harness에 직접 등록되는 11개 도구
- 타임스탬프 옵션이 있는 공개 영상 전사
- YouTube 검색, 채널, 재생목록, 자막 탐색
- 에이전트 워크플로를 위한 구조화된 결과

## 에이전트가 바로 쓸 수 있는 영상 소스

DeepSeek Harness용 전사는 네이티브 플러그인을 통해 에이전트를 transcript.im API에 연결합니다. 브라우저와 대화 사이에서 텍스트를 복사하게 하는 대신, 에이전트가 호출할 수 있는 도구를 제공합니다.

공개 영상 URL로 시작하거나 YouTube에서 소스를 찾으세요. 플러그인은 전사 메타데이터를 살펴보고, 텍스트를 가져오고, 에이전트가 다음 단계에서 쓸 수 있는 구조화된 데이터를 반환합니다. 타임스탬프 옵션은 인용이나 관찰을 원본과 연결해 줍니다. 영상 설명은 전사를 대신하지 못합니다. 실제로 발화된 단어를 가져와야 에이전트가 진짜로 인용할 수 있는 자료를 얻습니다.

플러그인은 가져오기와 탐색 도구를 제공합니다. 결과를 어떻게 쓸지는 에이전트가 정합니다. 연구 노트를 준비하든, 여러 강연을 비교하든, 새 글의 개요를 잡든 말입니다. 요약과 번역 프롬프트는 에이전트 워크플로에서 실행되며, 이 플러그인이 제공하는 별도의 AI 도구가 아닙니다.

## 링크에서 작업 가능한 소스로

소스 수집과 다음 연구 단계를 같은 DeepSeek Harness 세션에서 처리하세요.

### 1. 소스 고르기

에이전트에게 공개 영상 링크를 주거나 YouTube에서 특정 주제를 검색하게 하세요. 채널과 재생목록 작업이라면 어떤 소스를 처리할지 고르기 전에 관련 영상을 나열하게 하세요. YouTube 탐색 도구는 검색, 채널, 재생목록, 자막 메타데이터를 다룹니다.

### 2. 전사 가져오기

get_transcript_info로 사용 가능한 언어를 확인한 다음, get_transcript로 소스를 가져오세요. 다음 작업에 인용이 필요하면 타임스탬프와 메타데이터를 요청하세요. 요청에는 언어 우선순위를 지정하고 API를 통해 음성 인식을 요청할 수 있습니다.

### 3. 결과로 작업하기

에이전트에게 반환된 텍스트에서 인용을 추출하거나, 논지를 비교하거나, 노트를 준비하게 하세요. 결과와 함께 원본 URL과 타임스탬프를 남겨 두세요. 모음 작업이라면 배치를 만들고 상태를 확인한 뒤 완료된 결과를 내보내세요.

## 무엇을 만들 수 있는가

단일 소스든 반복 가능한 모음 워크플로든 같은 플러그인을 쓰세요.

### 추적 가능한 소스로 하는 연구

특정 질문을 위한 전사를 모으고, 에이전트가 직접 인용과 해석을 구분하게 하세요. 각 주장 옆에 소스 링크와 타임스탬프를 남겨, 결과를 믿기 전에 원본 녹음을 확인할 수 있게 하세요.

### 채널이나 재생목록 비교

YouTube 채널이나 재생목록의 영상을 나열하고, 관련 있는 묶음을 골라 배치로 제출하세요. 처리가 끝나면 하나의 클립을 전체 이야기로 취급하지 말고, 결과 전반에서 반복되는 주제나 달라지는 설명을 비교하세요.

### 녹음에서 콘텐츠 준비

에이전트에게 노트, 개요, 초안을 위한 소스 자료로 전사를 주세요. 이름, 인용, 맥락을 녹음과 대조해 확인하세요. 글은 에이전트가 쓰고, transcript.im은 그가 작업할 텍스트를 제공합니다.

### 전사 수집 자동화

정규 JSON 결과를 더 큰 워크플로에서 사용하세요. 내보내기 전에 배치 상태를 확인하고, 소스를 더 모을 때 페이지네이션 토큰을 보존하며, 별도의 탐색 클라이언트를 유지하지 말고 같은 도구 세트로 사용량을 확인하세요.

## 도구 11개, 플러그인 하나

네이티브 플러그인은 transcript.im 개발자 워크플로가 쓰는 것과 같은 REST 기능을 제공합니다. 가져오기는 YouTube, TikTok, Instagram, LinkedIn, Twitter/X의 공개 영상 URL을 지원하며, 탐색은 YouTube에 한정됩니다.

| 작업 | 도구 | 결과 |
| --- | --- | --- |
| 영상 읽기 | `get_transcript`, `get_transcript_info` | 전사 텍스트나 세그먼트, 메타데이터, 사용 가능한 언어 정보. |
| 모음 처리 | `create_batch`, `get_batch`, `export_batch` | 모니터링할 배치와 내보낼 완료 결과. |
| YouTube 소스 찾기 | `search_video`, `get_channel` | 소스를 고르기 위한 검색 결과와 채널 정보. |
| YouTube 모음 탐색 | `list_channel_video`, `list_playlist_item`, `list_caption` | 영상 목록, 재생목록 항목, 자막 메타데이터, 사용 가능한 경우 페이지네이션 토큰. `list_caption`은 YouTube가 공개하는 자막 트랙과 transcript.im이 제공할 수 있는 자막 텍스트를 읽으며, 음성 인식을 시작하지 않습니다. |
| 사용량 확인 | `get_usage` | 자격 증명과 연결된 API 사용량 정보. |

## Harness 프로필 연결

플러그인은 DeepSeek Harness 프로필 안에 transcript.im 도구를 등록하고, transcript.im 계정의 개발자 API 키로 REST API를 호출합니다.

- [개발자 API 키 만들기](/app/account/api-keys)
- [API 문서 읽기](/docs)

에이전트가 쓰는 프로필에 플러그인을 설치하세요. 예시는 사용자 컴퓨터에 있는 파일에서 플러그인 번들을 추가하며 transcript.im에서 아무것도 내려받지 않습니다. 프로필 이름과 경로는 본인 값으로 바꾸세요.

### Harness 프로필에 플러그인 설치

```
dsh plugin --profile research add ./transcript-im-dsh-plugin-0.1.0.tgz
```

계정에서 transcript.im 개발자 API 키를 만들고 Harness를 실행하는 프로세스에서 쓸 수 있게 하세요. 환경 변수를 쓰면 자격 증명이 대화에 들어가지 않습니다. 플러그인 구성의 명시적 apiKey가 환경 변수보다 우선하므로, 환경 변수를 쓰려면 오래된 구성 값을 지우세요.

### 자격 증명 구성 및 프로필 실행

```
export TRANSCRIPT_API_KEY="YOUR_TRANSCRIPT_API_KEY"
dsh --profile research
```

공개 영상 하나로 시작해 에이전트에게 전사 정보를 살펴보게 하세요. 더 긴 워크플로를 만들기 전에 자격 증명과 소스를 확인하는 방법입니다. 플러그인이 missing_api_key를 보고하면 다른 터미널 창이 아니라 실제 Harness 프로세스의 환경을 확인하세요.

## 알맞은 연결 고르기

에이전트가 이미 작업하는 런타임에 맞는 연결을 쓰세요. 네이티브 Harness 플러그인은 transcript.im MCP 서버를 중간 단계로 필요로 하지 않습니다.

| 연결 | 고를 때 | 맞는 방식 |
| --- | --- | --- |
| DeepSeek Harness 플러그인 | DeepSeek Harness에서 에이전트를 실행할 때. | Harness 프로필에 네이티브 도구를 등록하고 REST API를 호출합니다. |
| Transcript MCP 서버 | 클라이언트가 MCP로 도구를 연결할 때. | MCP 프로토콜로 전사와 탐색 작업을 제공합니다. |
| Transcript Skills | 런타임이 스킬 팩에서 지침을 불러올 때. | 에이전트를 위한 작업 안내와 워크플로를 제공합니다. |
| Transcript API | 애플리케이션이나 스크립트를 직접 제어할 때. | 코드가 REST 엔드포인트를 직접 호출하게 합니다. |

## 원본 결과 보존

모델 컨텍스트와 저장된 소스 데이터는 쓰임이 다릅니다. 단계마다 알맞은 출력을 쓰세요.

- 모델에 보이는 긴 전사 텍스트는 maxTranscriptChars로 제한되며 기본값은 20,000자입니다. 잘림 표시는 에이전트가 일부 발췌만 가지고 있음을 알려 줍니다. 정규 JSON 결과는 그대로 유지됩니다.
- 텍스트 배치 내보내기는 인라인으로 표시할 수 있습니다. ZIP 내보내기는 바이너리이므로, 모델용 응답은 압축 파일을 대화에 넣지 않고 설명만 합니다.
- YouTube 탐색 응답은 API가 제공하면 nextPageToken을 보존합니다. 첫 페이지를 반복하지 말고 그 토큰을 다음 요청에 넘겨 모음을 이어 가세요.
- 플러그인은 기본적으로 https://api.transcript.im로 요청을 보냅니다. baseUrl, timeoutMs, maxTranscriptChars는 구성할 수 있으며, 기본 요청 타임아웃은 30,000밀리초입니다.
- 소스 가용성과 전사 품질은 영상에 따라 다릅니다. 에이전트에게 가져오기 오류와 누락된 자료를 분명히 보고하게 하고, 인용은 원본 녹음과 대조해 확인하세요.

## 관련

- [API 문서](/docs)
- [Transcript REST API](/ko/api)
- [Transcript MCP 서버](/ko/mcp)
- [Transcript Skills](/ko/skills)
- [YouTube 자막 추출](/ko/youtube-transcript)
- [YouTube 영상 요약](/ko/youtube-video-summarizer)
- [YouTube 자막 생성](/ko/youtube-subtitle-generator)
- [YouTube 자막 다운로드](/ko/youtube-subtitle-downloader)
- [YouTube 채널 전사](/ko/youtube-channel-transcript)
- [YouTube 재생목록 전사](/ko/youtube-playlist-transcript)
## DeepSeek Harness 자주 묻는 질문

### DeepSeek Harness용 전사란 무엇인가요?

DeepSeek Harness용 전사는 네이티브 영상 전사와 YouTube 탐색 도구를 제공하는 transcript.im 플러그인입니다. Harness 프로필에 11개 도구를 등록하고 transcript.im REST API를 호출합니다.

### transcript.im 플러그인을 DeepSeek Harness에 어떻게 연결하나요?

에이전트가 쓰는 Harness 프로필에 플러그인 번들을 설치하고, transcript.im 계정에서 개발자 API 키를 만든 뒤, TRANSCRIPT_API_KEY로 또는 플러그인 구성에서 Harness 프로세스에 제공하세요. 연결 섹션에 두 단계가 모두 나와 있습니다.

### Harness 플러그인은 어떤 영상 플랫폼을 읽을 수 있나요?

전사 가져오기 도구는 YouTube, TikTok, Instagram, LinkedIn, Twitter/X의 공개 영상 URL을 받습니다. 검색, 채널, 재생목록, 자막 메타데이터 도구는 YouTube를 대상으로 합니다.

### DeepSeek Harness 플러그인에 MCP 서버가 필요한가요?

DeepSeek Harness 플러그인은 REST API를 직접 호출하므로 이 연결에는 transcript.im MCP 서버가 필요하지 않습니다. 클라이언트가 MCP 도구를 선호할 때 MCP 서버를 쓰세요.

### API 키는 플러그인에 어떻게 전달되나요?

플러그인 구성에 명시적 apiKey가 설정되어 있지 않으면 플러그인은 프로세스 환경에서 TRANSCRIPT_API_KEY를 읽습니다. 구성된 값이 우선하며, 자격 증명은 프롬프트가 아니라 그 환경이나 구성에 있어야 합니다.

### Harness 플러그인이 타임스탬프와 언어 정보를 반환할 수 있나요?

get_transcript_info로 사용 가능한 전사 언어를 확인하고, 전사를 가져올 때 includeTimestamp를 설정하세요. language 매개변수는 API가 지원하는 음성 인식 선호를 포함한 우선순위 목록을 받습니다.

### DeepSeek Harness가 재생목록을 배치로 처리할 수 있나요?

플러그인은 재생목록 탐색과 함께 create_batch, get_batch, export_batch를 제공합니다. 제출이 곧 완료라고 가정하지 말고, 에이전트가 원본 모음을 찾아 배치를 만들고 상태를 확인한 뒤 완료된 결과를 내보내게 하세요.

### 플러그인이 영상을 직접 요약하거나 번역하나요?

플러그인은 가져오기, 탐색, 배치, 사용량 도구를 제공합니다. 에이전트는 반환된 전사를 요약이나 번역 작업에 쓸 수 있지만, 플러그인은 별도의 AI 요약이나 번역 도구를 등록하지 않습니다.

### 긴 전사에 잘림 표시가 나오는 이유는 무엇인가요?

플러그인은 maxTranscriptChars로 모델 컨텍스트에 들어가는 전사 텍스트를 제한합니다. 표시는 발췌를 뜻하고 정규 JSON 결과는 그대로 남습니다. 에이전트는 생략된 내용을 읽었다고 주장해서는 안 됩니다.

### Harness에서 missing_api_key를 어떻게 해결하나요?

선택한 프로필을 실행하는 프로세스에 TRANSCRIPT_API_KEY나 구성된 apiKey가 있는지 확인하세요. 구성된 값이 있으면 환경 변수만 바꿔도 대체되지 않습니다.

### 플러그인을 다른 API 출처로 지정할 수 있나요?

배포에 transcript.im과 다른 API 출처가 필요하면 플러그인 구성에서 baseUrl을 설정하세요. 기본값은 https://api.transcript.im이며, 구성한 대상에 맞는 자격 증명을 유지하세요.

### Transcript Skills와 어떻게 다른가요?

Transcript Skills는 호환되는 에이전트가 따를 수 있는 작업과 워크플로를 설명합니다. DeepSeek Harness 플러그인은 런타임에 호출 가능한 도구를 등록합니다. 에이전트에 네이티브 Harness 연결이 필요할 때 선택하세요.

## Harness 에이전트에 소스를 제공하세요

개발자 API 키를 만들고 다음 연구 워크플로에 영상 전사를 가져오세요.

- [API 키 만들기](/app/account/api-keys)
- [API 문서 읽기](/docs)