AIsa YouTube Search

​

Install

npx skills add AIsa-team/agent-skills --skill aisa-youtube-search

npm install -g @aisa-one/cli
aisa skills install aisa-youtube-search

​

What can agents do with it?

​

When to use

• The user wants to search YouTube videos, channels, or playlists.
• The task needs region or language filters without direct Google API setup.
• The workflow can call the AIsa YouTube search endpoint with AISA_API_KEY.

​

When NOT to use

• The user needs browser automation, local scraping, or direct YouTube account actions.
• The workflow must avoid sending search requests to api.aisa.one.
• The request depends on a local helper script that is not part of this package.

​

Quick Reference

• Required environment variable: AISA_API_KEY
• Endpoint: https://api.aisa.one/apis/v1/youtube/search
• This package is curl-first and does not ship a local Python client.

​

Setup

export AISA_API_KEY="your-key"

​

Common Commands

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning+tutorial" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+news&gl=us&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&sp=EgIQAQ%3D%3D" \
  -H "Authorization: Bearer $AISA_API_KEY"

​

Capabilities

• Search YouTube SERP results with q
• Filter by locale with gl and hl
• Apply pagination or narrowing via sp
• Return structured results that may include videos or grouped sections

​

Guardrails

• Do not ask for Google credentials or browser cookies.
• Do not claim a result is local-only when it depends on relay requests.
• Do not fabricate missing filters or parameters.

​

Security Notes

• All search requests go to api.aisa.one.
• Required secret: AISA_API_KEY.
• This workflow does not require passwords, browser automation, or local scraping.

​

Get started

1. Sign up at aisa.one and create an API key in the console.
2. Set it in your shell: export AISA_API_KEY="your-key".
3. Install the skill with one of the commands under Install, then start a new agent session.

​

Related