recommend_ai_tools

Find AI tools that match a natural-language user need. Parameters ---------- description : str The user's need in their own words. Be specific about the scenario, audience, platform, language and budget when known. Examples: '我是新手想学编程，要免费的 AI 工具'; 'I need an AI to generate a 10-page PPT from an outline'. top_k : int (1-10, default 5) Maximum number of candidates to return. Returns ------- JSON: {intents, candidates, external}. ``candidates`` is already ranked by relevance & score. ``external`` lists fallback nav sites only when no in-catalog candidate matches.

get_ai_tool

Resolve and return the full structured record of one AI app. Parameters ---------- name_or_url : str The AI app's display name (e.g. 'Cursor', '通义千问'), its TrueAI slug, a numeric id, or its official URL (e.g. 'https://cursor.com'). include_reviews : bool (default false) If true, attach up to ``max_reviews`` real user reviews (sourced from watcha.cn). Useful for social proof / real-world usage tips. max_reviews : int (1-20, default 5) Cap on attached reviews. Resolution order: numeric id → exact slug → official_url substring → brand keyword from URL → fuzzy name/tagline match.

list_ai_tools

Browse the catalog with structured filters and sorting. Parameters ---------- category : str | None Optional category slug to filter by, e.g. 'coding', 'image-gen', 'writing'. Use list_categories() to discover slugs. free_only : bool | None If true, only return tools with a free tier. form_factor : str | None Filter by product form: 'saas' | 'mobile' | 'cli' | 'windows_app' | 'web' | 'browser_extension' | 'api'. sort : str (default 'overall') Sort key: 'overall' | 'usability' | 'effect' | 'price' | 'speed' | 'reviews' | 'new'. page : int (>=1, default 1) page_size : int (1-100, default 20) Returns ``{items, total, page, page_size}``. Each item is a brief record; call ``get_ai_tool`` to drill in.

list_categories

List every category in the TrueAI catalog. Each entry has ``slug``, ``name``, optional ``icon``, ``sort_order``, ``parent_id`` and ``tool_count``. Use the returned slugs to filter ``list_ai_tools(category=...)``.

No parameters.