{
  "markdown": "# Valyu Agent Skills\n\nAgent skills for integrating [Valyu](https://valyu.ai) APIs into AI agents and assistants. \n\nThese skills follow the [Agent Skills](https://agentskills.io) specification, making them compatible with Claude Code, Claude Desktop, and other agent platforms.\n\n## What is Valyu?\n\nValyu provides a unified API for AI agents to access real-time information across:\n\n- **Web** - General internet content\n- **Academic** - arXiv, PubMed, bioRxiv, medRxiv (40M+ papers)\n- **Financial** - SEC filings, earnings, stock data, crypto\n- **Healthcare** - Clinical trials, drug labels, ChEMBL, DrugBank\n- **Economic** - FRED, BLS, World Bank data\n- **News** - Real-time news with date/country filtering\n- **Predictions** - Polymarket, Kalshi odds\n- **Transportation** - UK Rail, ship tracking\n- **Patents** - US patent database\n\n## Available Skills\n\n| Skill | Description |\n|-------|-------------|\n| [valyu-search](valyu-search/valyu-best-practices/SKILL.md) | Complete Valyu API toolkit - search, content extraction, AI answers, deep research |\n\n## Quick Start\n\n### For AI Agents\n\n## Installation\n\n```bash\nnpx skills add valyuAI/skills\n```\n\nThe skill provides instructions for:\n- **Search API** - Find information across 25+ data sources\n- **Contents API** - Extract clean markdown from URLs\n- **Answer API** - Get AI-synthesized answers with citations\n- **DeepResearch API** - Generate comprehensive research reports\n\n### For Developers\n\n1. Get a Valyu API key at [platform.valyu.ai](https://platform.valyu.ai) ($10 free credits)\n\n2. Install the SDK:\n   ```bash\n   npm install valyu-js\n   # or\n   pip install valyu\n   ```\n\n3. Use the API:\n   ```typescript\n   import Valyu from 'valyu-js';\n\n   const valyu = new Valyu(\"your-api-key\");\n\n   // Search across all sources\n   const results = await valyu.search({\n     query: \"transformer architecture attention mechanism 2024\",\n     searchType: \"all\",\n     maxNumResults: 10\n   });\n\n   // Get AI-powered answer\n   const answer = await valyu.answer({\n     query: \"What are the latest developments in quantum computing?\"\n   });\n\n   // Extract content from URL\n   const content = await valyu.contents({\n     urls: [\"https://example.com/article\"],\n     summary: \"Extract key findings in 3 bullet points\"\n   });\n\n   // Deep research (async)\n   const task = await valyu.deepResearch.create({\n     query: \"AI chip market competitive landscape 2024\",\n     model: \"standard\"  // fast (~5min), standard (~15min), heavy (~90min)\n   });\n   ```\n\n## Project Structure\n\n```\nvalyu-agent-skills/\n├── README.md\n└── valyu-search/\n    ├── scripts/                    # CLI tools\n    └── best-practices/\n        ├── SKILL.md                # Main skill file (start here)\n        └── references/\n            ├── api-guide.md        # Complete API documentation\n            ├── recipes.md          # Index of all 27 recipes\n            ├── datasources.md      # Available data sources\n            ├── prompting.md        # Query writing best practices\n            ├── design-philosophy.md\n            ├── search-recipes/     # 14 search patterns\n            ├── content-recipes/    # 6 content extraction patterns\n            ├── answer-recipes/     # 4 answer generation patterns\n            ├── deepresearch-recipes/  # 3 research depth levels\n            └── integrations/       # 12 platform guides\n```\n\n## API Decision Tree\n\n```\nWhat do you need?\n\n├─ Find information across multiple sources\n│  └─ Search API (/v1/search)\n│\n├─ Extract content from specific URLs\n│  └─ Contents API (/v1/contents)\n│\n├─ Get an AI-synthesized answer with citations\n│  └─ Answer API (/v1/answer)\n│\n├─ Generate a comprehensive research report\n│  └─ DeepResearch API (/v1/deepresearch)\n│\n└─ Discover available data sources\n   └─ Datasources API (/v1/datasources)\n```\n\n## Recipes\n\n### Search Recipes\n\n| Recipe | Use Case |\n|--------|----------|\n| [basic-search-all](valyu-search/best-practices/references/search-recipes/basic-search-all.md) | Search across all sources |\n| [academic-search](valyu-search/best-practices/references/search-recipes/academic-search.md) | Research papers (arXiv, PubMed) |\n| [finance-search](valyu-search/best-practices/references/search-recipes/finance-search.md) | SEC filings, earnings, stocks |\n| [news-search](valyu-search/best-practices/references/search-recipes/news-search.md) | Real-time news with filtering |\n| [healthcare-and-bio-search](valyu-search/best-practices/references/search-recipes/healthcare-and-bio-search.md) | Clinical trials, drug data |\n\n### Content Recipes\n\n| Recipe | Use Case |\n|--------|----------|\n| [basic-content-extraction](valyu-search/best-practices/references/content-recipes/basic-content-extraction-from-web.md) | Clean markdown from URLs |\n| [structured-extraction](valyu-search/best-practices/references/content-recipes/structured-content-extraction-from-web.md) | Extract data via JSON schema |\n\n### Answer Recipes\n\n| Recipe | Use Case |\n|--------|----------|\n| [basic-answer](valyu-search/best-practices/references/answer-recipes/basic-answer.md) | AI answers with citations |\n| [answer-with-streaming](valyu-search/best-practices/references/answer-recipes/answer-with-streaming.md) | Progressive response generation |\n\n### DeepResearch Recipes\n\n| Recipe | Duration | Use Case |\n|--------|----------|----------|\n| [fast-research](valyu-search/best-practices/references/deepresearch-recipes/create-a-fast-research-task-and-await-completion.md) | ~5 min | Quick lookups |\n| [standard-research](valyu-search/best-practices/references/deepresearch-recipes/create-a-standard-research-task-and-await-completion.md) | ~15 min | Standard research |\n| [heavy-research](valyu-search/best-practices/references/deepresearch-recipes/create-a-heavy-research-task-and-await-completion.md) | ~90 min | Comprehensive analysis |\n\n## Integration Guides\n\n| Platform | Guide |\n|----------|-------|\n| Anthropic Claude | [integrations/anthropic.md](valyu-search/best-practices/references/integrations/anthropic.md) |\n| OpenAI | [integrations/openai.md](valyu-search/best-practices/references/integrations/openai.md) |\n| Vercel AI SDK | [integrations/vercel-ai-sdk.md](valyu-search/best-practices/references/integrations/vercel-ai-sdk.md) |\n| LangChain | [integrations/langchain.md](valyu-search/best-practices/references/integrations/langchain.md) |\n| LlamaIndex | [integrations/llamaindex.md](valyu-search/best-practices/references/integrations/llamaindex.md) |\n| MCP Server | [integrations/mcp-server.md](valyu-search/best-practices/references/integrations/mcp-server.md) |\n\n## Query Best Practices\n\n**Keep queries under 400 characters. Be specific, not verbose.**\n\n```\nBAD:  \"I want to know about AI\"\nGOOD: \"transformer attention mechanism survey 2024\"\n\nBAD:  \"Apple financial information\"\nGOOD: \"Apple revenue growth Q4 2024 earnings SEC filing\"\n```\n\n**Split complex requests into multiple queries:**\n\n```\n# Don't do this\n\"Tesla stock, products, and news\"\n\n# Do this instead\nQuery 1: \"Tesla stock performance Q4 2024\"\nQuery 2: \"Tesla Cybertruck production updates\"\nQuery 3: \"Tesla FSD autonomous driving progress\"\n```\n\nSee [prompting.md](valyu-search/best-practices/references/prompting.md) for the complete guide.\n\n## Links\n\n- [Valyu Platform](https://platform.valyu.ai) - Get API key\n- [Valyu Documentation](https://docs.valyu.ai) - Official docs\n- [Agent Skills Specification](https://agentskills.io) - Skill format spec\n- [valyu-js](https://www.npmjs.com/package/valyu-js) - TypeScript/JavaScript SDK\n- [valyu (Python)](https://pypi.org/project/valyu/) - Python SDK\n\n## License\n\nMIT\n",
  "bytes": 7548,
  "sha": "77d24cfe5690f68c7eaee8926759304b69a68ddaa4799a47066fb32cd87e12be",
  "repo_slug": "valyuai/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_valyuai_skills_valyu_best_practices_1d4ba226/readme"
}