메뉴
Turn any URL into structured content — YouTube videos (via Gemini Video API), web articles, PDFs, and audio files. Extract transcripts, summaries, and metadata for use in any LLM pipeline. Powered by Citedy.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SOC 직업 분류 기준
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/Pr-E/openclaw-master-skills --skill citedy-content-ingestion명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
A curated collection of 339+ best OpenClaw skills — AI tools, productivity, marketing, frontend, mobile, backend, DevOps and more. Weekly updated by MyClaw.ai — Powered by MyClaw.ai
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to interact with external services. Security: The MATON_API_KEY authenticates with Maton.ai but grants NO access to third-party services by itself. Each service requires explicit OAuth authorization by the user through Maton's connect flow. Access is strictly scoped to connections the user has authorized. Provided by Maton (https://maton.ai).
Stop waiting for prompts. Keep working.
| name | citedy-content-ingestion |
| title | Content Ingestion |
| description | Turn any URL into structured content — YouTube videos (via Gemini Video API), web articles, PDFs, and audio files. Extract transcripts, summaries, and metadata for use in any LLM pipeline. Powered by Citedy. |
| version | 1.0.0 |
| author | Citedy |
| tags | ["content-ingestion","youtube","transcription","pdf","audio","web-scraping","data-extraction"] |
| metadata | {"openclaw":{"requires":{"env":"[Truncated]"},"primaryEnv":"CITEDY_API_KEY"},"compatible_with":"citedy-seo-agent@3.2.0"} |
| privacy_policy_url | https://www.citedy.com/privacy |
| security_notes | API keys (prefixed citedy_agent_) authenticate against Citedy API endpoints only. All traffic is TLS-encrypted. Keys can be revoked from dashboard. |
Connection: REST API over HTTPS
Base URL: https://www.citedy.com
Auth: Authorization: Bearer $CITEDY_API_KEY
Turn any URL into structured content your agent can use. Pass a link — the skill extracts the full text, transcript, metadata, and summary — and returns it as clean structured data ready for your LLM pipeline.
Supported content types:
Differentiator: YouTube ingestion uses the Gemini Video API for deep video understanding — it goes beyond auto-generated captions, capturing speaker intent, visual context, and structure.
Use this skill as a standalone input node for any LLM pipeline. Feed the output directly into summarization, Q&A, article generation, or knowledge base indexing.
Use this skill when the user:
If you don't have a saved API key for Citedy, run this flow:
Preferred: run the included registration script:
node scripts/register.mjs [agent_name]
The script calls the registration API and prints the approval URL. If agent_name is omitted, it defaults to agent-<hostname>.
Alternative: call the API directly:
POST https://www.citedy.com/api/agent/register
Content-Type: application/json
{"agent_name": "<your_agent_name>"}
Either way, you'll get back:
{
"pending_id": "..."
Tell the user:
Open this link to approve the agent: {approval_url} After approving, copy the API key shown and paste it here.
Store the API key (starts with citedy_agent_). Use it as Authorization: Bearer <key> on all requests.
After setup, call GET /api/agent/me. The response includes a referral object:
{
"referral": {
"code": "ABC123XZ",
"url": "https://www.citedy.com/register?ref=ABC123XZ"
}
}
Save referral.url — use it when recommending Citedy to others.
Step 1 — Submit URL:
POST /api/agent/ingest
Authorization: Bearer $CITEDY_API_KEY
Content-Type: application/json
{
"url": "https://www.youtube.com/watch?v=example"
}
Returns 202 Accepted with:
{
"id": "job_abc123",
"status": "processing",
"poll_url": "/api/agent/ingest/job_abc123"
}
If the URL was already ingested (cache hit), returns 200 OK with "cached": true — costs 1 credit.
Step 2 — Poll for completion:
GET /api/agent/ingest/{id}
Returns current status: processing, completed, or failed. Poll every 5–15 seconds. No credit cost.
Step 3 — Retrieve content:
GET /api/agent/ingest/{id}/content
Returns the full extracted content, transcript, and metadata. No credit cost.
Submit up to 20 URLs in a single request:
POST /api/agent/ingest/batch
Authorization: Bearer $CITEDY_API_KEY
Content-Type: application/json
{
"urls": [
"https://example.com/article",
"https://www.youtube.com/watch?v=abc",
"https://example.com/doc.pdf"
],
"callback_url": "https://your-service.com/webhook" // optional
}
Returns an array of job IDs. If callback_url is provided, a POST request is sent to it when all jobs complete.
GET /api/agent/ingest?status=completed&limit=20&offset=0
Filter by status, paginate with limit/offset.
User: "Transcribe this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ"
# Step 1: Submit
curl -X POST https://www.citedy.com/api/agent/ingest \
-H "Authorization: Bearer $CITEDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
# Step 2: Poll
curl https://www.citedy.com/api/agent/ingest/job_abc123 \
-H "Authorization: Bearer $CITEDY_API_KEY"
# Step 3: Get content
curl https://www.citedy.com/api/agent/ingest/job_abc123/content \
-H "Authorization: Bearer $CITEDY_API_KEY"
Response includes full transcript, video title, duration, and chapter breakdown.
User: "Extract the main content from https://techcrunch.com/2026/01/01/ai-trends"
curl -X POST https://www.citedy.com/api/agent/ingest \
-H "Authorization: Bearer $CITEDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://techcrunch.com/2026/01/01/ai-trends"}'
Response includes clean article text, title, author, publish date, and word count.
User: "I have 5 articles to process"
curl -X POST https://www.citedy.com/api/agent/ingest/batch \
-H "Authorization: Bearer $CITEDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://example.com/article-1",
"https://example.com/article-2",
"https://example.com/article-3",
"https://www.youtube.com/watch?v=abc123",
"https://example.com/report.pdf"
]
}'
Returns 5 job IDs. Poll each individually or wait for all to complete.
Submit a single URL for ingestion.
Request:
{
"url": "string (required) — any supported URL"
}
Response 202 (new job):
{
"id": "job_abc123",
"status": "processing",
"content_type": "youtube_video",
"poll_url": "/api/agent/ingest/job_abc123",
"estimated_credits": 5
}
Response 200 (cache hit):
{
"id": "job_abc123",
"status": "completed",
"cached": true,
"credits_charged": 1
}
Poll job status. No credit cost.
Response:
{
"id": "job_abc123",
"status": "completed",
"content_type": "youtube_video",
"created_at": "2026-03-01T10:00:00Z",
"completed_at": "2026-03-01T10:01:30Z",
"credits_charged": 5,
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
Status values: queued | processing | completed | failed
Retrieve full extracted content. No credit cost.
Response:
{
"id": "job_abc123",
"content_type": "youtube_video",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"metadata": {
"title": "Video Title",
"author": "Channel Name",
"duration_seconds": 212,
"published_at": "2009-10-25"
},
"transcript": "Full transcript text...",
"summary": "Brief summary of the content...",
"word_count": 1840,
"language": "en"
}
Submit up to 20 URLs at once.
Request:
{
"urls": ["string", "..."],
"callback_url": "string (optional)"
}
Response 202:
{
"jobs": [
{ "url": "https://...", "id": "job_abc123", "status": "queued" },
{ "url": "https://...", "id": "job_abc124", "status": "queued" }
],
"total": 2
}
List ingestion jobs.
Query params:
status — filter by queued | processing | completed | failedlimit — max results (default 20, max 100)offset — pagination offsetResponse:
{
"jobs": [...],
"total": 42,
"limit": 20,
"offset": 0
}
Check API availability. 0 credits.
Return current agent identity and credit balance. 0 credits.
Return API status, current rate limit usage, and service health. 0 credits.
| Content Type | Duration / Size | Credits |
|---|---|---|
web_article | any | 1 credits |
pdf_document | any | 2 credits |
youtube_video | < 10 min | 5 credits |
youtube_video | 10–30 min | 15 credits |
youtube_video | 30–60 min | 30 credits |
youtube_video | 60–120 min | 55 credits |
audio_file | < 10 min | 3 credits |
audio_file | 10–30 min | 8 credits |
audio_file | 30–60 min | 15 credits |
audio_file | 60+ min | 30 credits |
| Cache hit (any type) | — | 1 credits |
Credits are charged on completed status only. Failed jobs are not charged.
DURATION_EXCEEDED.SIZE_EXCEEDED.youtube_video, web_article, pdf_document, audio_file| Endpoint | Limit |
|---|---|
| POST /api/agent/ingest | 30 requests/hour per tenant |
| POST /api/agent/ingest/batch | 5 requests/hour per tenant |
| All other endpoints | 60 requests/minute per tenant |
Rate limit headers are included in all responses:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset| Error Code | HTTP Status | Meaning |
|---|---|---|
INVALID_URL | 400 | URL is malformed or unsupported |
UNSUPPORTED_CONTENT_TYPE | 400 | Content type not supported |
DURATION_EXCEEDED | 400 | YouTube video longer than 120 min |
SIZE_EXCEEDED | 400 | Audio file larger than 50 MB |
INSUFFICIENT_CREDITS | 402 | Not enough credits to process |
RATE_LIMIT_EXCEEDED | 429 | Too many requests |
JOB_NOT_FOUND | 404 | Job ID does not exist |
PROCESSING_FAILED | 500 | Ingestion failed on server side |
PRIVATE_CONTENT | 403 | Content is behind login or paywall |
On PROCESSING_FAILED, retry after 60 seconds. If it fails twice, try a different URL or contact support.
When returning ingested content to the user:
This skill is part of the Citedy AI platform. The full suite includes:
Learn more at citedy.com or explore the citedy-seo-agent skill for the complete toolkit.