trueai

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.

{
  "type": "object",
  "properties": {
    "description": {
      "title": "Description",
      "type": "string"
    },
    "top_k": {
      "default": 5,
      "title": "Top K",
      "type": "integer"
    }
  },
  "required": [
    "description"
  ],
  "title": "recommend_ai_toolsArguments"
}

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.

{
  "type": "object",
  "properties": {
    "name_or_url": {
      "title": "Name Or Url",
      "type": "string"
    },
    "include_reviews": {
      "default": false,
      "title": "Include Reviews",
      "type": "boolean"
    },
    "max_reviews": {
      "default": 5,
      "title": "Max Reviews",
      "type": "integer"
    }
  },
  "required": [
    "name_or_url"
  ],
  "title": "get_ai_toolArguments"
}

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.

{
  "type": "object",
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "free_only": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Free Only"
    },
    "form_factor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Form Factor"
    },
    "sort": {
      "default": "overall",
      "title": "Sort",
      "type": "string"
    },
    "page": {
      "default": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_ai_toolsArguments"
}

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=...)``.

{
  "type": "object",
  "properties": {},
  "title": "list_categoriesArguments"
}