You.com Web Search & Research API

**Breaking change:** Skill renamed and repositioned for direct HTTP API integration in any language. - Renamed from "youdotcom-cli" to "youdotcom-api" to reflect broad, language-agnostic API access. - Description and documentation now target developers integrating You.com APIs via direct HTTP (no Bash-specific examples). - Compatibility expanded to all languages with HTTP client support; CLI tool requirements (curl, jq) removed. - Allowed tools now enable install commands for any developer environment (Read/Write/Edit/Bash with pip/npm/bun). - Improved API reference, use-case guidance, and developer onboarding instructions. - No code changes detected in this update.

3.0.0 is a major update: now uses curl and You.com's public REST API directly. - Added support for three endpoints: Search (no API key needed), Research (with citations), and Contents (content extraction). - Reworked examples for direct curl + jq usage; removed CLI dependency. - Provided JSON schemas for all request/response types. - Search endpoint works on free tier; API key only required for Research and Contents. - Enhanced workflow, clearer tool-selection logic, and stronger prompt-injection safety guidance.

youdoctom-cli 2.0.7 changelog: - Emphasized strict safety: all full page content (from `livecrawl` or `contents`) must be wrapped in `<external-content>...</external-content>` variables before passing to reasoning. - Added clear examples of secure Bash usage, including safe variable assignment and output wrapping. - Updated quick start and examples to warn against passing untrusted content directly. - Strengthened security section with explicit boundary marker requirements and direct ignore-instructions advice. - Improved documentation clarity around handling and filtering external data for agent safety.

- Added security section with prompt injection defense guidelines. - Emphasized that all fetched content is untrusted external data; instruct users to summarize and not act on web instructions. - Clarified jq usage to extract only specific fields from results for safe processing. - Included package verification steps in installation instructions. - Revised allowed-tools scope to limit execution to @youdotcom-oss/api only.

- Added license, compatibility, allowed-tools, and metadata fields to SKILL.md. - Declared required environment: Bun 1.3+ or Node.js 18+ with internet access. - Listed compatible bash tools and package keywords in metadata. - No changes to usage instructions, commands, or workflow.

- metadata section and internal configuration removed from skill manifest - No user-facing functionality changes - Documentation, usage, and example content unchanged - Version bump to 2.0.4, but no workflow or API changes

youdoctom 2.0.3 — No file changes detected - No modifications found since previous release (2.0.2). - No impact to workflows, installation, or CLI usage. - Documentation, triggers, and feature coverage unchanged.

- Metadata section updated in SKILL.md for better machine-readability and install instructions. - Enhanced metadata now includes a repository link and explicit environment variable/binary requirements. - Added primary environment variable indicator and new install methods for Bun and Node.js in the metadata. - No code or workflow logic changes; all usage examples and documentation remain unchanged.

**This update improves environment and security guidance for You.com CLI integration.** - Added explicit version and integrity pinning for the `@youdotcom-oss/api` package, including installation methods and update guidance. - Documented supported runtimes and binaries with minimum versions and verification commands. - Included detailed package security checks and provenance verification steps. - Enhanced upgrade workflow: clarified patch vs. minor update procedures and when to review changelogs. - Clarified installation, local vs global usage, and rationale for version constraints to ensure reliability.

Major update: Streamlined documentation, improved error handling, and enhanced reproducibility. - Simplified and clarified all usage instructions with updated, shorter CLI examples. - Improved environment variable management and added explicit credential setup steps (YDC_API_KEY, YDC_CLIENT). - Detailed error handling section with specific exit codes and patterns for parsing responses. - Integrated official links for package source, npm, and homepage in metadata. - Emphasized simultaneous search+content (livecrawl) as core advantage. - Removed deprecated deep-search features, focusing on search and content extraction.

**Summary:** Major documentation update for the youdotcom-cli tool, focusing on agent integration and streamlined usage. - Full rewrite of SKILL.md with comprehensive setup, agent workflow, and CLI instructions. - Emphasizes schema-driven JSON API for seamless integration with bash-based AI agents. - Details key features: livecrawl (search + extraction in one call), research-grade citations, and express vs deep research modes. - Provides usage patterns, troubleshooting, and environment requirements (Node.js 18+/Bun). - Outlines advanced command examples, schema discovery, and command-line parsing tips. - Clarifies tool selection based on user intent and feature set.