Microsoft Azure Custom Search Client — CustomSearch

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Custom Search Client — CustomSearch
  description: 'Microsoft Azure Custom Search Client — CustomSearch. 1 operations. Lead operation: Microsoft Azure The Custom
    Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found In Your Custom View Of The Web. Self-contained
    Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - CustomSearch
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: custom-search-client-customsearch
    baseUri: https://api.cognitive.microsoft.com/bingcustomsearch/v7.0
    description: Microsoft Azure Custom Search Client — CustomSearch business capability. Self-contained, no shared references.
    resources:
    - name: search
      path: /search
      operations:
      - name: microsoftazurecustominstancesearch
        method: GET
        description: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found
          In Your Custom View Of The Web
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Accept
          in: header
          type: string
          description: The default media type is application/json. To specify that the response use [JSON-LD](http://json-ld.org/),
            set the Accept header to application/ld+json.
        - name: Accept-Language
          in: header
          type: string
          description: A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing
            order of preference. For additional information, in
        - name: User-Agent
          in: header
          type: string
          description: The user agent originating the request. Bing uses the user agent to provide mobile users with an optimized
            experience. Although optional, you are strongly encou
        - name: X-MSEdge-ClientID
          in: header
          type: string
          description: 'Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often
            flights new features and improvements, and it uses the client '
        - name: X-MSEdge-ClientIP
          in: header
          type: string
          description: The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location.
            Bing uses the location information to determine safe sear
        - name: X-Search-Location
          in: header
          type: string
          description: A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing
            uses the location information to determine safe search beha
        - name: customConfig
          in: query
          type: string
          description: The identifier for the custom search configuration
          required: true
        - name: cc
          in: query
          type: string
          description: 'A 2-character country code of the country where the results come from. This API supports only the
            United States market. If you specify this query parameter, it '
        - name: count
          in: query
          type: integer
          description: The number of search results to return in the response. The default is 10 and the maximum value is
            50. The actual number delivered may be less than requested.Us
        - name: mkt
          in: query
          type: string
          description: The market where the results come from. Typically, mkt is the country where the user is making the
            request from. However, it could be a different country if the
        - name: offset
          in: query
          type: integer
          description: The zero-based offset that indicates the number of search results to skip before returning results.
            The default is 0. The offset should be less than (totalEstim
        - name: q
          in: query
          type: string
          description: The user's search query term. The term may not be empty. The term may contain Bing Advanced Operators.
            For example, to limit results to a specific domain, use t
          required: true
        - name: safeSearch
          in: query
          type: string
          description: 'A filter used to filter adult content. Off: Return webpages with adult text, images, or videos. Moderate:
            Return webpages with adult text, but not adult images '
        - name: setLang
          in: query
          type: string
          description: The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language
            code. For example, the language code for English is E
        - name: textDecorations
          in: query
          type: boolean
          description: 'A Boolean value that determines whether display strings should contain decoration markers such as
            hit highlighting characters. If true, the strings may include '
        - name: textFormat
          in: query
          type: string
          description: The type of markers to use for text decorations (see the textDecorations query parameter). Possible
            values are Raw—Use Unicode characters to mark content that n
  exposes:
  - type: rest
    namespace: custom-search-client-customsearch-rest
    port: 8080
    description: REST adapter for Microsoft Azure Custom Search Client — CustomSearch. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/search
      name: search
      description: REST surface for search.
      operations:
      - method: GET
        name: microsoftazurecustominstancesearch
        description: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found
          In Your Custom View Of The Web
        call: custom-search-client-customsearch.microsoftazurecustominstancesearch
        with:
          Accept: rest.Accept
          Accept-Language: rest.Accept-Language
          User-Agent: rest.User-Agent
          X-MSEdge-ClientID: rest.X-MSEdge-ClientID
          X-MSEdge-ClientIP: rest.X-MSEdge-ClientIP
          X-Search-Location: rest.X-Search-Location
          customConfig: rest.customConfig
          cc: rest.cc
          count: rest.count
          mkt: rest.mkt
          offset: rest.offset
          q: rest.q
          safeSearch: rest.safeSearch
          setLang: rest.setLang
          textDecorations: rest.textDecorations
          textFormat: rest.textFormat
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: custom-search-client-customsearch-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Custom Search Client — CustomSearch. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-custom-search-api
      description: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found
        In Your Custom View Of The Web
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: custom-search-client-customsearch.microsoftazurecustominstancesearch
      with:
        Accept: tools.Accept
        Accept-Language: tools.Accept-Language
        User-Agent: tools.User-Agent
        X-MSEdge-ClientID: tools.X-MSEdge-ClientID
        X-MSEdge-ClientIP: tools.X-MSEdge-ClientIP
        X-Search-Location: tools.X-Search-Location
        customConfig: tools.customConfig
        cc: tools.cc
        count: tools.count
        mkt: tools.mkt
        offset: tools.offset
        q: tools.q
        safeSearch: tools.safeSearch
        setLang: tools.setLang
        textDecorations: tools.textDecorations
        textFormat: tools.textFormat
      outputParameters:
      - type: object
        mapping: $.