skydeckai-code 0.1.26__tar.gz → 0.1.28__tar.gz

skydeckai_code-0.1.26/README.md → skydeckai_code-0.1.28/PKG-INFO

@@ -1,6 +1,42 @@
+Metadata-Version: 2.4
+Name: skydeckai-code
+Version: 0.1.28
+Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.
+Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
+Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
+Project-URL: Documentation, https://github.com/skydeckai/skydeckai-code/blob/main/README.md
+Author-email: "SkyDeck.ai" <support@skydeck.ai>
+License: Apache 2.0
+License-File: LICENSE
+Keywords: ai,aidd,code,code-analysis,development,mcp
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.13.3
+Requires-Dist: gitpython>=3.1.44
+Requires-Dist: html2text>=2025.4.15
+Requires-Dist: mcp>=1.6.0
+Requires-Dist: mss>=10.0.0
+Requires-Dist: pillow>=11.1.0
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: pygetwindow>=0.0.9
+Requires-Dist: pyobjc-framework-quartz>=11.0
+Requires-Dist: requests>=2.32.3
+Requires-Dist: tree-sitter-c-sharp>=0.23.1
+Requires-Dist: tree-sitter-cpp>=0.23.4
+Requires-Dist: tree-sitter-go>=0.23.4
+Requires-Dist: tree-sitter-java>=0.23.5
+Requires-Dist: tree-sitter-javascript>=0.23.1
+Requires-Dist: tree-sitter-kotlin>=1.1.0
+Requires-Dist: tree-sitter-php>=0.23.11
+Requires-Dist: tree-sitter-python>=0.23.6
+Requires-Dist: tree-sitter-ruby>=0.23.1
+Requires-Dist: tree-sitter-rust==0.23.2
+Requires-Dist: tree-sitter-typescript>=0.23.2
+Requires-Dist: tree-sitter>=0.24.0
+Description-Content-Type: text/markdown
+
 # SkyDeckAI Code
 
-An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
+An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
 
 # Formerly Known As MCP-Server-AIDD
 
@@ -63,7 +99,8 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 -   Code content searching with regex pattern matching
 -   Multi-language code execution with safety measures
 -   Git operations (status, diff, commit, branch management, cloning)
--   Web content fetching from APIs and websites
+-   Web content fetching from APIs and websites with HTML-to-markdown conversion
+-   Multi-engine web search with reliable fallback mechanisms
 -   Batch operations for parallel and serial tool execution
 -   Security controls with configurable workspace boundaries
 -   Screenshot and screen context tools
@@ -495,7 +532,8 @@ Fetches content from a URL and optionally saves it to a file.
         "Accept": "application/json"
     },
     "timeout": 15,
-    "save_to_file": "downloads/octocat.json"
+    "save_to_file": "downloads/octocat.json",
+    "convert_html_to_markdown": true
 }
 ```
 
@@ -506,9 +544,10 @@ Fetches content from a URL and optionally saves it to a file.
 | headers | object | No | Optional HTTP headers to include in the request |
 | timeout | integer | No | Maximum time to wait for response (default: 10s) |
 | save_to_file | string | No | Path to save response content (within allowed directory) |
+| convert_html_to_markdown | boolean | No | When true, converts HTML content to markdown for better readability (default: true) |
 
 **Returns:**
-Response content as text with HTTP status code and size information. For binary content, returns metadata and saves to file if requested.
+Response content as text with HTTP status code and size information. For binary content, returns metadata and saves to file if requested. When convert_html_to_markdown is enabled, HTML content is automatically converted to markdown format for better readability.
 
 This tool can be used to access web APIs, fetch documentation, or download content from the web while respecting size limits (10MB max) and security constraints.
 
@@ -526,6 +565,59 @@ skydeckai-code-cli --tool web_fetch --args '{
     "url": "https://github.com/github/github-mcp-server/blob/main/README.md",
     "save_to_file": "downloads/readme.md"
 }'
+
+# Fetch a webpage and convert to markdown for better readability
+skydeckai-code-cli --tool web_fetch --args '{
+    "url": "https://example.com",
+    "convert_html_to_markdown": true
+}'
+```
+
+#### web_search
+
+Performs a robust web search using multiple search engines and returns concise, relevant results.
+
+```json
+{
+    "query": "latest python release features",
+    "num_results": 8,
+    "convert_html_to_markdown": true,
+    "search_engine": "bing"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| query | string | Yes | The search query to process. Be specific for better results. |
+| num_results | integer | No | Maximum number of search results to return (default: 10, max: 20) |
+| convert_html_to_markdown | boolean | No | When true, content will be converted from HTML to markdown for better readability (default: true) |
+| search_engine | string | No | Specifies which search engine to use: "auto" (default), "bing", or "duckduckgo" |
+
+**Returns:**
+A list of search results formatted in markdown, including titles, URLs, and snippets for each result. Results are deduplicated and organized hierarchically for easy reading.
+
+This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
+
+**Example Usage:**
+
+```bash
+# Search with default settings (auto engine selection)
+skydeckai-code-cli --tool web_search --args '{
+    "query": "latest python release features"
+}'
+
+# Try DuckDuckGo if you want alternative results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "machine learning frameworks comparison",
+    "search_engine": "duckduckgo"
+}'
+
+# Use Bing for reliable results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "best programming practices 2023",
+    "search_engine": "bing"
+}'
 ```
 
 ### Utility Tools

skydeckai_code-0.1.26/PKG-INFO → skydeckai_code-0.1.28/README.md

@@ -1,40 +1,6 @@
-Metadata-Version: 2.4
-Name: skydeckai-code
-Version: 0.1.26
-Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching, code content searching, and system information retrieval.
-Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
-Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
-Project-URL: Documentation, https://github.com/skydeckai/skydeckai-code/blob/main/README.md
-Author-email: "SkyDeck.ai" <support@skydeck.ai>
-License: Apache 2.0
-License-File: LICENSE
-Keywords: ai,aidd,code,code-analysis,development,mcp
-Requires-Python: >=3.11
-Requires-Dist: gitpython>=3.1.44
-Requires-Dist: mcp>=1.6.0
-Requires-Dist: mss>=10.0.0
-Requires-Dist: pillow>=11.1.0
-Requires-Dist: psutil>=7.0.0
-Requires-Dist: pygetwindow>=0.0.9
-Requires-Dist: pyobjc-framework-quartz>=11.0
-Requires-Dist: requests>=2.32.3
-Requires-Dist: tree-sitter-c-sharp>=0.23.1
-Requires-Dist: tree-sitter-cpp>=0.23.4
-Requires-Dist: tree-sitter-go>=0.23.4
-Requires-Dist: tree-sitter-java>=0.23.5
-Requires-Dist: tree-sitter-javascript>=0.23.1
-Requires-Dist: tree-sitter-kotlin>=1.1.0
-Requires-Dist: tree-sitter-php>=0.23.11
-Requires-Dist: tree-sitter-python>=0.23.6
-Requires-Dist: tree-sitter-ruby>=0.23.1
-Requires-Dist: tree-sitter-rust==0.23.2
-Requires-Dist: tree-sitter-typescript>=0.23.2
-Requires-Dist: tree-sitter>=0.24.0
-Description-Content-Type: text/markdown
-
 # SkyDeckAI Code
 
-An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
+An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
 
 # Formerly Known As MCP-Server-AIDD
 
@@ -97,7 +63,8 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 -   Code content searching with regex pattern matching
 -   Multi-language code execution with safety measures
 -   Git operations (status, diff, commit, branch management, cloning)
--   Web content fetching from APIs and websites
+-   Web content fetching from APIs and websites with HTML-to-markdown conversion
+-   Multi-engine web search with reliable fallback mechanisms
 -   Batch operations for parallel and serial tool execution
 -   Security controls with configurable workspace boundaries
 -   Screenshot and screen context tools
@@ -529,7 +496,8 @@ Fetches content from a URL and optionally saves it to a file.
         "Accept": "application/json"
     },
     "timeout": 15,
-    "save_to_file": "downloads/octocat.json"
+    "save_to_file": "downloads/octocat.json",
+    "convert_html_to_markdown": true
 }
 ```
 
@@ -540,9 +508,10 @@ Fetches content from a URL and optionally saves it to a file.
 | headers | object | No | Optional HTTP headers to include in the request |
 | timeout | integer | No | Maximum time to wait for response (default: 10s) |
 | save_to_file | string | No | Path to save response content (within allowed directory) |
+| convert_html_to_markdown | boolean | No | When true, converts HTML content to markdown for better readability (default: true) |
 
 **Returns:**
-Response content as text with HTTP status code and size information. For binary content, returns metadata and saves to file if requested.
+Response content as text with HTTP status code and size information. For binary content, returns metadata and saves to file if requested. When convert_html_to_markdown is enabled, HTML content is automatically converted to markdown format for better readability.
 
 This tool can be used to access web APIs, fetch documentation, or download content from the web while respecting size limits (10MB max) and security constraints.
 
@@ -560,6 +529,59 @@ skydeckai-code-cli --tool web_fetch --args '{
     "url": "https://github.com/github/github-mcp-server/blob/main/README.md",
     "save_to_file": "downloads/readme.md"
 }'
+
+# Fetch a webpage and convert to markdown for better readability
+skydeckai-code-cli --tool web_fetch --args '{
+    "url": "https://example.com",
+    "convert_html_to_markdown": true
+}'
+```
+
+#### web_search
+
+Performs a robust web search using multiple search engines and returns concise, relevant results.
+
+```json
+{
+    "query": "latest python release features",
+    "num_results": 8,
+    "convert_html_to_markdown": true,
+    "search_engine": "bing"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| query | string | Yes | The search query to process. Be specific for better results. |
+| num_results | integer | No | Maximum number of search results to return (default: 10, max: 20) |
+| convert_html_to_markdown | boolean | No | When true, content will be converted from HTML to markdown for better readability (default: true) |
+| search_engine | string | No | Specifies which search engine to use: "auto" (default), "bing", or "duckduckgo" |
+
+**Returns:**
+A list of search results formatted in markdown, including titles, URLs, and snippets for each result. Results are deduplicated and organized hierarchically for easy reading.
+
+This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
+
+**Example Usage:**
+
+```bash
+# Search with default settings (auto engine selection)
+skydeckai-code-cli --tool web_search --args '{
+    "query": "latest python release features"
+}'
+
+# Try DuckDuckGo if you want alternative results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "machine learning frameworks comparison",
+    "search_engine": "duckduckgo"
+}'
+
+# Use Bing for reliable results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "best programming practices 2023",
+    "search_engine": "bing"
+}'
 ```
 
 ### Utility Tools

{skydeckai_code-0.1.26 → skydeckai_code-0.1.28}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "skydeckai-code"
-version = "0.1.26"
-description = "This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching, code content searching, and system information retrieval."
+version = "0.1.28"
+description = "This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval."
 readme = "README.md"
 requires-python = ">=3.11"
 authors = [{name = "SkyDeck.ai", email = "support@skydeck.ai"}]
@@ -29,6 +29,8 @@ dependencies = [
     "pyobjc-framework-Quartz>=11.0",
     "pillow>=11.1.0",
     "requests>=2.32.3",
+    "html2text>=2025.4.15",
+    "beautifulsoup4>=4.13.3",
 ]
 
 [tool.hatch.build.targets.wheel]

{skydeckai_code-0.1.26 → skydeckai_code-0.1.28}/src/aidd/tools/__init__.py

@@ -77,7 +77,7 @@ from .screenshot_tool import (
     handle_capture_screenshot,
 )
 from .system_tools import get_system_info_tool, handle_get_system_info
-from .web_tools import web_fetch_tool, handle_web_fetch
+from .web_tools import web_fetch_tool, handle_web_fetch, web_search_tool, handle_web_search
 
 # Export all tools definitions
 TOOL_DEFINITIONS = [
@@ -125,6 +125,7 @@ TOOL_DEFINITIONS = [
     read_image_file_tool(),
     # Web tools
     web_fetch_tool(),
+    web_search_tool(),
 ]
 
 # Export all handlers
@@ -173,4 +174,5 @@ TOOL_HANDLERS = {
     "read_image_file": handle_read_image_file,
     # Web handlers
     "web_fetch": handle_web_fetch,
+    "web_search": handle_web_search,
 }