{
    "id": "search_site",
    "name": "Search the official site",
    "description": "Search services, Studio, contacts, public pages, applications and articles. For custom development or company questions search here, not only search_apps. Missing results do not prove a service is absent.",
    "version": "2.1.0",
    "effect": "read",
    "generated": false,
    "endpoint": "https://blackorder.io/api/agent/tools/search_site",
    "method": "POST",
    "mcp": {
        "url": "https://blackorder.io/mcp",
        "tool": "search_site"
    },
    "inputSchema": {
        "type": "object",
        "properties": {
            "query": {
                "type": "string",
                "maxLength": 500
            },
            "language": {
                "type": "string",
                "enum": [
                    "en",
                    "it"
                ],
                "default": "en"
            },
            "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20
            }
        },
        "required": [
            "query"
        ],
        "additionalProperties": false
    },
    "outputSchema": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
            "results": {
                "type": "array",
                "items": {
                    "type": "object",
                    "properties": {
                        "canonical_url": {
                            "type": "string",
                            "format": "uri"
                        },
                        "official_page_url": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "title": {
                            "type": "string"
                        },
                        "description": {
                            "type": [
                                "string",
                                "null"
                            ]
                        },
                        "version": {
                            "type": [
                                "string",
                                "null"
                            ]
                        },
                        "minimum_os": {
                            "type": [
                                "string",
                                "null"
                            ]
                        },
                        "architecture": {
                            "type": [
                                "array",
                                "null"
                            ],
                            "items": {
                                "type": "string"
                            }
                        },
                        "price": {
                            "type": [
                                "number",
                                "null"
                            ]
                        },
                        "currency": {
                            "type": [
                                "string",
                                "null"
                            ]
                        },
                        "is_free": {
                            "type": [
                                "boolean",
                                "null"
                            ]
                        },
                        "signed": {
                            "type": [
                                "boolean",
                                "null"
                            ]
                        },
                        "notarized": {
                            "type": [
                                "boolean",
                                "null"
                            ]
                        },
                        "facts": {
                            "type": "object",
                            "additionalProperties": {
                                "type": "object",
                                "required": [
                                    "value",
                                    "source",
                                    "verified_at",
                                    "freshness",
                                    "confidence",
                                    "type"
                                ],
                                "properties": {
                                    "value": {},
                                    "source": {
                                        "type": "object",
                                        "required": [
                                            "url",
                                            "publisher",
                                            "type"
                                        ],
                                        "properties": {
                                            "url": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "publisher": {
                                                "type": "string"
                                            },
                                            "type": {
                                                "type": "string"
                                            }
                                        }
                                    },
                                    "verified_at": {
                                        "type": "null"
                                    },
                                    "freshness": {
                                        "type": "object",
                                        "properties": {
                                            "retrieved_at": {
                                                "type": "string",
                                                "format": "date-time"
                                            },
                                            "max_age_seconds": {
                                                "type": "integer"
                                            }
                                        }
                                    },
                                    "confidence": {
                                        "enum": [
                                            "publisher_declared",
                                            "unknown"
                                        ]
                                    },
                                    "type": {
                                        "const": "publisher_statement"
                                    },
                                    "verification_scope": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    },
                    "additionalProperties": true
                }
            }
        },
        "required": [
            "results"
        ]
    },
    "examples": [
        {
            "input": {
                "query": "sviluppo",
                "language": "it"
            },
            "expected": "Matching official site records with coverage and sources."
        }
    ],
    "fallback": {
        "url": "https://blackorder.io/agents/catalog",
        "text": "https://blackorder.io/llms-full.txt",
        "limitations": "Publisher catalog; automatic compatibility evaluation requires REST or MCP."
    }
}