Ddg Search

🚀 鴨子🦆的項目

鴨子（Duck） 是一款功能強大的工具集合，能助力用戶高效開展網絡搜索、URL 內容抓取以及元數據提取，極大提升信息獲取的效率。

🚀 快速開始

安裝

npm install duck

使用示例

基礎用法

// 網絡搜索示例
const { webSearch } = require('duck');

webSearch({
  query: '人工智能',
  numResults: 5,
  page: 2
}).then(results => {
  console.log(results);
});

// URL內容抓取示例
const { fetchUrl } = require('duck');

fetchUrl({
  url: 'https://example.com',
  maxLength: 10000
}).then(content => {
  console.log(content);
});

✨ 主要特性

• 網絡搜索工具：支持自定義查詢參數，可靈活返回指定數量的搜索結果。
• URL內容抓取：能精準提取網頁主內容，且支持多種格式輸出。
• 元數據提取：可快速獲取目標 URL 的標題、描述等基本信息。

📦 安裝指南

使用以下命令進行安裝：

npm install duck

💻 使用示例

基礎用法

// 網絡搜索
const { webSearch } = require('duck');

webSearch({
  query: '人工智能',
  numResults: 5,
  page: 2
}).then(results => {
  console.log(results);
});

// URL內容抓取
const { fetchUrl } = require('duck');

fetchUrl({
  url: 'https://example.com',
  maxLength: 10000
}).then(content => {
  console.log(content);
});

📚 詳細文檔

網絡搜索工具 (web-search)

• 參數：
  • query（必填）：搜索關鍵詞。
  • page（可選，默認為1）：頁碼。
  • numResults（可選，默認為10）：結果數量（範圍1 - 20）。

URL內容抓取工具 (fetch-url)

• 參數：
  • url（必填）：目標網頁地址。
  • maxLength（可選，默認為10000）：最大返回長度。
  • extractMainContent（可選，默認為true）：是否提取主內容。
  • includeLinks（可選，默認為true）：是否包含鏈接文本。
  • includeImages（可選，默認為true）：是否包含圖片描述。
  • excludeTags（可選）：排除特定標籤。

元數據提取工具 (url-metadata)

• 參數：
  • url（必填）：目標網頁地址。

🔧 技術細節

項目結構

bin/              # 命令行接口
src/
  index.js        # 主入口文件
  tools/          # 工具定義與實現
    searchTool.js
    fetchUrlTool.js
    metadataTool.js
  utils/          # 輔助工具與函數
    search.js     # 搜索與URL相關功能
package.json
README.md

🤝 貢獻指南

歡迎社區貢獻！請通過提交問題或 Pull Request 參與項目。

⚠️ 重要提示

請遵循現有代碼風格，併為新功能添加測試用例。

📺 YouTube 頻道

@OEvortex

📄 許可證

本項目使用 Apache License 2.0 協議，具體內容請參考 LICENSE 文件。

由 @OEvortex 開發 ❤️