chore: update

.vscode/settings.json

@@ -5,5 +5,8 @@
   "editor.codeActionsOnSave": {
     "source.fixAll": "explicit",
     "source.organizeImports": "explicit"
-  }
+  },
+  "cSpell.words": [
+    "Sogou"
+  ]
 }

openapi.yaml

@@ -65,6 +65,66 @@ paths:
                   error:
                     type: string
                     example: "Internal Server Error"
+
+  /bing:
+    get:
+      operationId: Bing Search
+      summary: Perform a search on Bing
+      description: Returns search results from Sogou based on the query parameter.
+      parameters:
+        - name: search
+          in: query
+          required: true
+          description: The search query.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: A JSON array of search results.
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    title:
+                      type: string
+                      description: The title of the search result.
+                      example: "Example Search Result Title"
+                    link:
+                      type: string
+                      description: The URL of the search result.
+                      example: "https://example.com"
+                    description:
+                      type: string
+                      description: A brief description of the search result.
+                      example: "This is an example description of a search result."
+                    text:
+                      type: string
+                      description: The text of the search result.
+                      example: "This is an example text of a search result."
+        "400":
+          description: Bad request, search query parameter is missing.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: "search query parameter is required"
+        "500":
+          description: Internal server error.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: "Internal Server Error"
+
 components:
   securitySchemes:
     apiKey:

src/utils.mjs

@@ -31,6 +31,9 @@ export function asyncExpressMiddleware(fn) {
 export function createCommonSearchAPI(options) {
   return asyncExpressMiddleware(async (req, res) => {
     const { search } = req.query;
+    if (!search) {
+      return res.status(400).json({ error: "search query is required" });
+    }
     const browser = await puppeteer.connect({
       browserWSEndpoint: process.env.PW_REMOTE_URL,
     });