agentleFS
YepAPIYepAPI/skills/SKILL.md

yepapi

Skill8 starsChanged 7 months agoMITView on GitHub

Full API context for YepAPI — 30 endpoints for SEO, SERP, web scraping, YouTube, and AI. Plus 110 skills for Next.js, React, TypeScript, shadcn/ui, security, SEO, dashboards, and more.

  • Reads credentials
Files
SKILL.md

YepAPI — API Reference

Base URL: https://api.yepapi.com Auth: x-api-key header Response: { ok: true, data: {...} } or { ok: false, error: { code, message } } Rate limit: 60 req/min

SEO — Keywords

MethodPathCostRequiredDescription
POST/v1/seo/keywords$0.15keywords[], locationBulk metrics: volume, CPC, difficulty, intent, trends (up to 100)
POST/v1/seo/keywords/ideas$0.03keyword, locationKeyword suggestions from seed
POST/v1/seo/keywords/related$0.03keyword, locationRelated keywords for seed

Returns: volume, cpc, difficulty (0-100), intent (informational/commercial/navigational/transactional), trend (12-month array)

SERP

MethodPathCostRequiredDescription
POST/v1/serp/google$0.01query, locationGoogle organic results
POST/v1/serp/google/news$0.01query, locationGoogle News results
POST/v1/serp/google/maps$0.01query, locationGoogle Maps / local results

Returns: results[] with title, url, snippet, position. Maps adds rating, reviews, address, phone.

Domain Analysis

MethodPathCostRequiredDescription
POST/v1/seo/domain/overview$0.01domainTraffic, keywords, backlinks, domain rank
POST/v1/seo/domain/keywords$0.04domainKeywords a domain ranks for
POST/v1/seo/domain/backlinks$0.05domainDomain backlink profile

Returns: overview gives traffic, keywords_count, backlinks, domain_rank. Keywords gives keyword, position, volume, url.

Competitors

MethodPathCostRequiredDescription
POST/v1/seo/competitors$0.04domainCompetitor domains by keyword overlap
POST/v1/seo/keyword-gap$0.04domain, competitorKeyword gap between two domains

Returns: competitors gives domain, overlap, traffic. Gap gives keyword, your_position, competitor_position, volume.

Backlinks

MethodPathCostRequiredDescription
POST/v1/seo/backlinks$0.05targetIndividual backlinks to domain/URL
POST/v1/seo/backlinks/summary$0.03targetAggregate metrics + dofollow ratio
POST/v1/seo/referring-domains$0.03targetReferring domains with authority

Returns: summary gives total_backlinks, dofollow_ratio, domain_rank. Backlinks gives source_url, anchor, type, domain_rank.

On-Page & Trends

MethodPathCostRequiredDescription
POST/v1/seo/page-audit$0.03urlTechnical SEO audit (meta, headings, links, images)
POST/v1/seo/lighthouse$0.05urlLighthouse scores (performance, a11y, SEO, best practices)
POST/v1/seo/trends$0.02keywords[]Google Trends interest over time (up to 5 keywords)

Returns: page-audit gives issues[], meta, headings, links, images. Lighthouse gives performance, accessibility, seo, best_practices (0-100). Trends gives interest_over_time[].

AI Visibility

MethodPathCostRequiredDescription
POST/v1/seo/ai/chatgpt$0.05queryWhat ChatGPT says about a brand/query
POST/v1/seo/ai/gemini$0.05queryWhat Gemini says about a brand/query

Returns: response (text), mentions[], sentiment.

Web Scraping

MethodPathCostRequiredDescription
POST/v1/scrape$0.01urlScrape to markdown/HTML/text
POST/v1/scrape/js$0.02urlJS-rendered scrape (headless browser)
POST/v1/scrape/stealth$0.03urlAnti-bot bypass (residential proxies)
POST/v1/scrape/ai-extract$0.03url, promptAI-powered structured extraction

Optional: format ("markdown"/"html"/"text"), waitFor (CSS selector), timeout (ms). Returns: content (string), metadata (title, description, url).

YouTube

MethodPathCostRequiredDescription
POST/v1/youtube/search$0.01querySearch videos, channels, playlists
POST/v1/youtube/video$0.02videoIdFull video metadata + formats
POST/v1/youtube/transcript$0.01videoIdTranscript with timestamps
POST/v1/youtube/channel$0.01channelId or handleChannel overview
POST/v1/youtube/comments$0.01videoIdComments and replies

Returns: search gives results[] with videoId, title, views, published. Transcript gives segments[] with text, start, duration.

AI Chat

MethodPathCostRequiredDescription
POST/v1/ai/chatvariablemodel, messages[]Chat with 69 AI models
GET/v1/ai/modelsfree—List available models + pricing

Common Optional Fields

SEO endpoints: location (default "us"), language (default "en"), limit, offset. Scraping endpoints: format, waitFor, timeout.

Error Codes

CodeHTTPMeaning
INVALID_API_KEY401Missing or invalid key
REVOKED_API_KEY401Key revoked
NO_CREDITS402Insufficient balance
RATE_LIMITED42960 req/min exceeded
VALIDATION_ERROR400Bad request body
UPSTREAM_ERROR502Provider error
MODEL_NOT_FOUND400Invalid AI model
AI_UPSTREAM_ERROR502AI provider error
STREAM_ERROR502SSE interrupted
NOT_FOUND404Endpoint not found
INTERNAL_ERROR500Server error

Links

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.