Update app.py

app.py

@@ -7,10 +7,23 @@ import requests
 # Initialize FastMCP agent
 mcp = FastMCP("Canada Job Bank Scraper Agent")
 
+
 @mcp.tool(name="search_jobs")
 def search_jobs_tool(query: str, location: str, limit: int = 10, salary: str = None, job_type: str = None):
+    """
+    Scrape job listings from the Canada Job Bank website based on a search query and location.
+
+    Args:
+        query (str): Job title or keyword to search for.
+        location (str): Location to filter jobs.
+        limit (int): Maximum number of job results to return (default: 10).
+        salary (str, optional): Ignored in this scraper but included for future API compatibility.
+        job_type (str, optional): Ignored in this scraper but included for future API compatibility.
+
+    Returns:
+        dict: A dictionary with a list of job listings or an error message.
+    """
     base_url = "https://www.jobbank.gc.ca/jobsearch/jobsearch?"
-
     params = {
         "searchstring": query,
         "locationstring": location,
@@ -32,9 +45,9 @@ def search_jobs_tool(query: str, location: str, limit: int = 10, salary: str = N
         response.raise_for_status()
 
         soup = BeautifulSoup(response.text, "html.parser")
-
         jobs = []
-        cards = soup.find_all("article", class_="resultJobItem")  # Job listings container
+
+        cards = soup.find_all("article", class_="resultJobItem")
 
         for card in cards[:limit]:
             title_elem = card.find("a", class_="resultJobItem-title")
@@ -59,6 +72,19 @@ def search_jobs_tool(query: str, location: str, limit: int = 10, salary: str = N
 
 
 def search_jobs_ui(query, location, limit=10, salary=None, job_type=None):
+    """
+    Interface function for displaying job search results in markdown format.
+
+    Args:
+        query (str): Job title or keyword.
+        location (str): Location to search in.
+        limit (int): Number of results to return.
+        salary (str, optional): Placeholder argument (not used).
+        job_type (str, optional): Placeholder argument (not used).
+
+    Returns:
+        str: Markdown-formatted job listings or error message.
+    """
     result = search_jobs_tool(query, location, limit, salary, job_type)
 
     if "error" in result:
@@ -86,7 +112,7 @@ app = gr.Interface(
         gr.Textbox(label="Job Type (optional, ignored)")
     ],
     outputs="markdown",
-    title="Canada Job Bank Job Search (with requests & BeautifulSoup) + FastMCP",
+    title="Canada Job Bank Job Search (requests & BeautifulSoup) + FastMCP",
     description="Search jobs by scraping Canada Job Bank using requests and BeautifulSoup."
 )