octen-team/octen-skills

octen-video-search

USE FOR finding web videos by a text query, powered by Octen.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/octen-team/octen-skills --skill octen-video-search

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Octen Video Search

Find web videos by a text query. Each result includes the matched segment (start/end timestamps within the video), duration, cover image, source page, and author — so you can jump straight to the relevant moment.

In Beta. Contact us to request beta access. Octen Video Search is in invite-only beta — request access via https://octen.ai (or support@octen.ai). Calls will fail without access; if so, tell the user it's in beta and how to reach Octen.

API Key Setup

Before searching, ensure `OCTEN_API_KEY` is set. If it is missing — or any call returns `401` — stop and do not retry blindly: tell the user a key is required, point them to https://octen.ai, help them configure it for their agent, then continue once it's set. A `403` means the key is valid but the request was refused — either no beta access or insufficient account balance; relay both possibilities and how to request beta access.

Configure the key for the relevant agent (same as other Octen skills):

  • Claude Code — add { "env": { "OCTEN_API_KEY": "your-key" } } to ~/.claude/settings.json
  • Cursor / generic shell — export OCTEN_API_KEY="your-key" in ~/.zshrc or ~/.bashrc
  • Codex — ~/.codex/config.toml → [shell_environment_policy], set = { OCTEN_API_KEY = "your-key" }
  • OpenClaw — add OCTEN_API_KEY=your-key to ~/.openclaw/.env

Endpoint

http
POST https://api.octen.ai/video-search

Authentication: X-Api-Key: <API_KEY> header · Content-Type: application/json

Quick Start (cURL)

bash
curl -s -X POST "https://api.octen.ai/video-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "how to tie a tie"}],
    "count": 5
  }'

With Time Filtering

bash
curl -s -X POST "https://api.octen.ai/video-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "GPT-5 launch keynote"}],
    "count": 10,
    "time_range": "month"
  }'

Parameters

| Parameter | Type | Required | Default | Description | |--|--|--|--|--| | inputs | array | Yes | - | One text input: [{"type": "text", "data": "<query>"}] (query max 500 chars) | | count | integer | No | 5 | Number of results (1–10) | | time_range | string | No | - | Relative time window: day, week, month, year (or d, w, m, y) | | start_time | string | No | - | Start time filter, ISO 8601 | | end_time | string | No | - | End time filter, ISO 8601 (must be after start_time) | | safesearch | string | No | strict | Adult content filter: off or strict |

Response Format

| Field | Type | Description | |--|--|--| | request_id | string | Unique request identifier | | data.results[] | array | List of video results | | data.results[].title | string | Video title | | data.results[].url | string | Video URL | | data.results[].source_page | string | Page the video was found on | | data.results[].description | string? | Video description | | data.results[].cover_url | string? | Cover/thumbnail image URL | | data.results[].duration_seconds | integer? | Total video duration in seconds | | data.results[].match_segment | object? | Matched segment {start_seconds, end_seconds} | | data.results[].authors | string? | Channel / author | | data.results[].time_published | string? | Publish time, ISO 8601 | | data.results[].time_last_crawled | string? | Last crawl time, ISO 8601 | | meta.latency | number | Response time in milliseconds | | meta.warning | string? | Warning message, if any |

Error Codes

| HTTP Status | Description | |--|--| | 400 | Missing or invalid parameter | | 401 | Invalid or missing API key | | 403 | Insufficient balance, or no beta access | | 429 | Rate limited | | 500 | Internal server error |

Notes

  • Input is text only today ({"type": "text", "data": "..."}).
  • match_segment gives the timestamps of the most relevant moment — surface them so the user can jump straight to it.
  • count is capped at 10.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
octen-team
커뮤니티

octen-extract

USE FOR extracting clean, LLM-ready content from one or more web page URLs, powered by Octen. Fetch 1-20 URLs in one call and get markdown/text content plus a page category, page-structure label, and (optionally) query-driven highlights. Use it for reading articles, scraping pages for RAG/grounding, summarization, or fact lookup from known URLs. It can also list the links on a page.

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 29일
octen-team
커뮤니티

octen-search

USE FOR web search, news, company or person lookup, and fast URL lookup. Real-time web search for AI agents powered by Octen, with dedicated endpoints for news (returns storylines, not just articles), business lookup (returns company and person cards), and pulse (predicts the URL a query means in ~10ms, for docs and known sites). Fast, fresh, and relevant — returns ranked results with highlights, full content, domain filtering, and time filtering. Average response under 80ms with minute-level in

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 29일
octen-team
커뮤니티

octen-web-search

Use Octen's search tools for anything that needs live information from the web. Make sure to use this skill whenever the user wants to look something up, check current or recent information, find sources, compare products / vendors / pricing, research a topic, or read a specific web page — even if they never mention Octen or the word "search". Also use it before falling back to any built-in web search tool.

1시간 설치 수
1
GitHub Stars
10
업데이트
10월 29일