Web search via Yep Search API. Own index, fast results with domain filtering and date ranges.

Web search via Yep Search API. Own index, fast results with domain filtering and date ranges.

Security Scan

The skill is internally consistent: a small Python CLI that calls the Yep Search API and only requires the YEP_API_KEY and python3 as declared.

Purpose & Capability

Name/description, required binary (python3), required env var (YEP_API_KEY), and included script all align with providing Yep Search queries. Nothing requested is unrelated to web search.

Instruction Scope

SKILL.md instructs running the included scripts/search.py with arguments; the script only builds a JSON body and POSTs to https://platform.yep.com/api/search. It does not read other files, system secrets, or contact unexpected endpoints.

Install Mechanism

No install spec — instruction-only usage with a bundled Python script. No downloads, package installs, or archive extraction; risk from install mechanism is minimal.

Credentials

Only YEP_API_KEY is required and declared as the primary credential. The script only reads that env var; there are no other credential or config path requests.

Persistence & Privilege

always is false (no forced persistence). The skill does not modify other skills or system settings; it runs as a simple CLI tool and does not request elevated presence.

Assessment

This skill appears to do exactly what it says: run a small Python script that queries the Yep Search API. Before installing, ensure you keep your YEP_API_KEY secret (don’t paste it into public prompts), be aware that API calls may incur charges and are rate-limited, and confirm you trust platform.yep.com. Because the skill can make outbound network requests, only provide the API key to agents you trust. If you need stronger isolation, run the script manually in a controlled environment rather than granting it to an autonomous agent.

Yep Search

Web search using the Yep Search API. Independent index — not a Google/Bing proxy. Returns URLs, titles, descriptions, and optional content highlights.

Search

python3 {baseDir}/scripts/search.py "query"
python3 {baseDir}/scripts/search.py "query" -n 20
python3 {baseDir}/scripts/search.py "query" --highlights
python3 {baseDir}/scripts/search.py "query" --mode fast
python3 {baseDir}/scripts/search.py "query" --lang en
python3 {baseDir}/scripts/search.py "query" --include-domains "docs.rs,crates.io"
python3 {baseDir}/scripts/search.py "query" --safe
python3 {baseDir}/scripts/search.py "query" --after 2026-01-01

Options

• -n <count>: Number of results (default: 10, max: 100)
• --highlights: Return content highlights (costs ~$0.009/call vs $0.004 basic)
• --mode <mode>: fast or balanced (default)
• --lang <code>: ISO 639-1 language code (e.g., en, de, ja)
• --include-domains <domains>: Comma-separated domains to restrict search to
• --exclude-domains <domains>: Comma-separated domains to exclude
• --safe: Enable safe search (exclude adult content)
• --after <date>: Only results published after this date (ISO 8601)
• --before <date>: Only results published before this date (ISO 8601)
• --crawl-after <date>: Only results crawled after this date
• --crawl-before <date>: Only results crawled before this date

Notes:

• Requires YEP_API_KEY from https://platform.yep.com/app
• $10 free credit on signup (no card required)
• Basic search: $0.004/call ($4/1k), Highlights: $0.009/call ($9/1k)
• Rate limits: 60/min, 3,600/hr, 86,400/day
• 180+ languages supported
• Zero external dependencies — uses only Python stdlib