Microsoft Azure Local Search Client — LocalSearch

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Local Search Client — LocalSearch
  description: 'Microsoft Azure Local Search Client — LocalSearch. 1 operations. Lead operation: Microsoft Azure The Local
    Search Api Lets You Send A Search Query To Bing And Get Back Search Results That Include Local Businesses Such As Restaurants,
    Hotels, Retail Stores, Or Other Local Businesses The Query Can Specify The Name Of The Local Business Or It Can Ask For
    A List For Example, Restaurants Near Me. Self-'
  tags:
  - Microsoft Azure
  - LocalSearch
  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: local-search-client-localsearch
    baseUri: https://api.cognitive.microsoft.com/bing
    description: Microsoft Azure Local Search Client — LocalSearch business capability. Self-contained, no shared references.
    resources:
    - name: v7.0-localbusinesses-search
      path: /v7.0/localbusinesses/search
      operations:
      - name: microsoftazurelocalsearch
        method: GET
        description: 'Microsoft Azure The Local Search Api Lets You Send A Search Query To Bing And Get Back Search Results
          That Include Local Businesses Such As Restaurants, Hotels, Retail Stores, Or Other Local Businesses The Query Can
          Specify The Name Of The '
        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: Pragma
          in: header
          type: string
          description: 'By default, Bing returns cached content, if available. To prevent Bing from returning cached content,
            set the Pragma header to no-cache (for example, Pragma: no'
        - 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: 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: mkt
          in: query
          type: string
          description: The market where the results come from. You are strongly encouraged to always specify the market, if
            known. Specifying the market helps Bing route the request a
        - name: q
          in: query
          type: string
          description: The user's search term.
          required: true
        - name: localcategories
          in: query
          type: string
          description: comma-delimited list of business categories to search for. Supported categories can be high-level such
            as EatDrink, Shop, SeeDo.
        - name: localcircularview
          in: query
          type: string
          description: 'Preferred location to search around, expressed as Latitude, longitude and radius in meters. For example
            47.61503,-122.1719,5000. Note that circular view should '
        - name: localmapview
          in: query
          type: string
          description: Preferred bounding box for results, specified in NW_latitude, NW_Longitude, SE_Latitude, SE_Longitude
            format. For example 47.64,-122.13,47.63,-122.12. These val
        - name: count
          in: query
          type: string
          description: Preferred number of results to return. If not specified, then Bing returns 1-20 of the most relevant
            results.
        - name: first
          in: query
          type: string
          description: First result to return. zero-based. default is 0.
        - name: ResponseFormat
          in: query
          type: array
          description: 'The media type to use for the response. The following are the possible case-insensitive values: JSON,
            JSONLD. The default is JSON. If you specify JSONLD, the re'
        - 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
  exposes:
  - type: rest
    namespace: local-search-client-localsearch-rest
    port: 8080
    description: REST adapter for Microsoft Azure Local Search Client — LocalSearch. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/v7-0/localbusinesses/search
      name: v7-0-localbusinesses-search
      description: REST surface for v7.0-localbusinesses-search.
      operations:
      - method: GET
        name: microsoftazurelocalsearch
        description: 'Microsoft Azure The Local Search Api Lets You Send A Search Query To Bing And Get Back Search Results
          That Include Local Businesses Such As Restaurants, Hotels, Retail Stores, Or Other Local Businesses The Query Can
          Specify The Name Of The '
        call: local-search-client-localsearch.microsoftazurelocalsearch
        with:
          Accept: rest.Accept
          Accept-Language: rest.Accept-Language
          Pragma: rest.Pragma
          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
          cc: rest.cc
          mkt: rest.mkt
          q: rest.q
          localcategories: rest.localcategories
          localcircularview: rest.localcircularview
          localmapview: rest.localmapview
          count: rest.count
          first: rest.first
          ResponseFormat: rest.ResponseFormat
          SafeSearch: rest.SafeSearch
          SetLang: rest.SetLang
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: local-search-client-localsearch-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Local Search Client — LocalSearch. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-local-search-api
      description: 'Microsoft Azure The Local Search Api Lets You Send A Search Query To Bing And Get Back Search Results
        That Include Local Businesses Such As Restaurants, Hotels, Retail Stores, Or Other Local Businesses The Query Can
        Specify The Name Of The '
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: local-search-client-localsearch.microsoftazurelocalsearch
      with:
        Accept: tools.Accept
        Accept-Language: tools.Accept-Language
        Pragma: tools.Pragma
        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
        cc: tools.cc
        mkt: tools.mkt
        q: tools.q
        localcategories: tools.localcategories
        localcircularview: tools.localcircularview
        localmapview: tools.localmapview
        count: tools.count
        first: tools.first
        ResponseFormat: tools.ResponseFormat
        SafeSearch: tools.SafeSearch
        SetLang: tools.SetLang
      outputParameters:
      - type: object
        mapping: $.