Search KSP mods by name, author, tags, and/or KSP version compatibility, paginated.

Args: name: Case-insensitive regex matched against mod identifier and display name. Examples: "engineer", "^MechJeb", "visual|scatter" author: Case-insensitive regex matched against mod author(s). A mod matches if any of its authors match. Examples: "sarbian", "squad|nertea" tags: List of tags to filter by. Examples: ["plugin"], ["parts", "resources"] tags_mode: How to combine multiple tags — "and" (mod must have all tags, default) or "or" (mod must have at least one tag). ksp_versions: KSP game versions to filter by. A mod matches if any of its released versions supports at least one of the given KSP versions. Uses prefix matching, so "1.12" matches "1.12.0", "1.12.5", etc. Examples: ["1.12"], ["1.11", "1.12"] sort_by: Sort order — "downloads" (default), "downloads asc", "name", "name desc", "download_size", "download_size asc", "install_size", "install_size asc", "updated", "updated asc". cached_only: If True, only return mods whose ZIP is present in the local CKAN download cache. Requires CKAN to have been used to download mods. limit: Number of results per page (default 20, max 100). offset: Pagination offset (default 0).

Returns JSON with keys: total, offset, limit, results. Each result has: identifier, name, abstract, tags, authors, max_ksp_version, latest_version, last_updated_at, download_count, download_size (bytes), install_size (bytes). Results include is_cached: true only for mods present in the CKAN download cache.

Get details for a KSP mod by its CKAN identifier.

Args: identifier: Exact CKAN identifier (e.g. "MechJeb2", "Trajectories"). Use search_mods to find identifiers first. categories: Which detail categories to include. Defaults to ["metadata"]. Available categories: - "metadata": name, abstract, authors, tags, license, version info (max_ksp_version, latest_version, last_updated_at), download_count, resources - "relations": depends, recommends, suggests, conflicts, provides - "install": install directives - "versions": full version history with per-version KSP compatibility - "github": GitHub repo stats, README preview, and latest release. Lazily fetched and cached (TTL 7 days). Includes fetched_at timestamp. - "spacedock": SpaceDock stats, descriptions, and latest version info. Lazily fetched and cached (TTL 3 days). Includes fetched_at timestamp. - "raw": full raw CKAN JSON (superset of all above) force_refresh: If True, bypass the cache TTL and re-fetch all requested enrichment categories (github, spacedock) from their sources.

Returns an error object if the mod is not found. Metadata results include is_cached: true if the mod's ZIP is in the CKAN download cache.

Get mods related to a given list of mods via CKAN dependency/recommendation relationships.

For each result, shows the same fields as search_mods plus the relationship category and which input mods it was found through.

If the same mod appears via multiple input mods or multiple relationship types, it is deduplicated: the highest-priority category wins, and all source mods are listed.

Args: identifiers: List of CKAN mod identifiers to find recommendations for. Use search_mods to find identifiers first. categories: Which relationship categories to include. Defaults to ["depends", "recommends", "suggests"]. Available categories (in priority order): - "depends": mods that the input mods depend on - "supports": mods that the input mods declare support for - "recommends": mods recommended by the input mods - "suggests": mods suggested by the input mods - "depends_by": mods that depend on any of the input mods - "supported_by": mods that declare support for any of the input mods - "recommended_by": mods that recommend any of the input mods - "suggested_by": mods that suggest any of the input mods Pass ["all"] to include all categories. limit: Number of results per page (default 20, max 100). offset: Pagination offset (default 0).

Returns JSON with keys: total, offset, limit, results. Each result has: identifier, name, abstract, tags, authors, max_ksp_version, latest_version, last_updated_at, download_count, download_size, install_size, category, related_mods.

List all tags used in the CKAN mod index, with mod counts.

Args: limit: Maximum number of tags to return, ordered by popularity (default 50).

Returns JSON list of {tag, count} objects.

Return current status of the CKAN mod index.

Reports total mod count, number with download data, number with tags, and when the index was last harvested.

List the KSP parts included in a mod's cached download ZIP.

Only works for mods whose ZIP is present in the local CKAN download cache (i.e., mods you have downloaded via CKAN). Use index_status to check whether ckan_cache_available is true, and search_mods with cached_only=true to find mods that are cached.

Parts are scanned from GameData/{identifier}/Parts/**/*.cfg inside the ZIP. Bundled dependencies under other GameData/ subdirectories are ignored. Titles are resolved from the mod's English localization file where available.

Args: identifier: Exact CKAN mod identifier (e.g. "HeatControl", "NearFuturePropulsion"). detail: Level of detail to return: - "summary": total part count and breakdown by category (cheapest) - "basic": per-part name, resolved title, and category (default) - "long": basic + cost, mass, tech_required, bulkhead_profiles, modules (list of supported module type names), unsupported_modules (list of unsupported module type names), resources (list of resource names). Use get_part_tool for full module and resource detail.

Returns JSON. On success: summary: {total_parts, categories: {CategoryName: count}} basic/long: {total_parts, categories, parts: [...]} Returns an error object if the mod is not cached or the ZIP cannot be read.

Get full details for a single KSP part from a mod's cached download ZIP.

Returns structured part data including formatted stats for all supported modules (engines, RCS, reaction wheels, solar panels, etc.) and a list of unsupported module names.

Use list_parts_tool with detail="basic" first to get valid part names. Only works for mods present in the local CKAN download cache.

Args: identifier: Exact CKAN mod identifier (e.g. "CryoEngines"). part_name: Internal part name as it appears in the CFG file (e.g. "cryoengine-stromboli-1"). This is the "name" field, not the display title. Use list_parts_tool to find it.

Returns a part object with: name, title, category, cost, mass, tech_required, bulkhead_profiles, modules (list of formatted module data per supported module type), unsupported_modules (list of module type names with no formatter), resources (list of {name, amount, max_amount}). Returns an error object if the mod is not cached, the ZIP cannot be read, or the part name is not found.

Re-harvest the CKAN-meta archive to update the mod index.

By default, this is a no-op if nothing has changed upstream (ETag check). Use force=True to bypass the check and rebuild unconditionally.

Args: force: Bypass ETag check and re-download/re-index everything.

Returns JSON with harvest result: status ("skipped" or "updated") and stats.