> For the complete documentation index, see [llms.txt](https://docs.talordata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talordata.com/cn-tw/serp-api/integration/sdk-integration/talordata-and-n8n-integration-guide.md). # 如何將TalorData與n8n集成 你可以透過 n8n-nodes-talordata-serp 社群節點將 TalorData 整合到 n8n。完成設定後，即可在 n8n 工作流程中直接調用 TalorData SERP API，從 Google、Bing、DuckDuckGo、Yandex 等搜尋引擎取得結構化搜尋結果。 ### 概覽 n8n是一個工作流自動化平臺，可通過視覺化方式連接應用、API和AI Agent。 TalorData提供SERP API能力，適用於實时搜索結果獲取、當地化搜索分析、SEO監控、市場調研以及Agent驅動的Web數據工作流。 通過TalorData n8n集成，你可以： * 在 n8n 中運行 Google、Bing、DuckDuckGo、Yandex 等 SERP 搜尋。 * 使用國家/地區、語言、設備、市場等本地化搜尋參數。 * 將搜尋結果連接到 AI Agent、報告管線、警告、數據增強等工作流。 * 在需要更高控制度的場景下，透過原始請求模式傳入高階 SERP 參數。 ### 前置條件 開始之前，請確保你已經具備： * 一個可用的n8n實例。 * 安裝n8n社區節點的權限。 * 一個以sk\_開頭的 [**TalorData SERP API Key**](https://dashboard.talordata.com/scraping/serp-api/api-token)。 ### 具體步驟 {% stepper %} {% step %} ### 安裝 在 n8n 的 Community Nodes 面板中安裝 TalorData 節點： * 開啟你的 n8n 實例。 * 創建新工作流，或打開已有工作流進行編輯，並搜索 talordata。 * 點擊安裝節點。 **安裝完成後，n8n會新增：** * 一個名為 `Talordata SERP API` 的憑證類型。 * 一個名為 `Talordata SERP` 的工作流節點。 {% endstep %} {% step %} #### 配寘憑證 在將節點加入生產工作流之前，建議先創建TalorData憑證： * 在 n8n 中開啟 Credentials。 * 新建憑證，並選擇 Talordata SERP API。 * 粘貼你的 TalorData SERP API Key。 * 除非你正在測試內部開發環境，否則保持默認 endpoint。 * 儲存或測試該憑證。 {% hint style="success" icon="filter" %} 憑證測試請求和工作流執行請求都會向TalorData發送以下來源標識，用於平臺使用統計： {% endhint %} ``` Origin: n8n ``` {% endstep %} {% step %} #### 創建第一個工作流 在n8n中運行TalorData搜索： * 創建一個新工作流，或開啟已有工作流。 * 新增 Talordata SERP 節點。 * 選擇你的 Talordata SERP API 憑證。 * 選擇一個 Operation，例如 Google Search。 * 填寫該操作顯示的字段。 * 執行節點。 節點會傳回TalorData SERP JSON 回應，以及所選操作的請求元數據。你可以將輸出結果傳遞給下游 n8n 節點，例如 AI Agent、Code 節點、數據庫、表格、通知或報告工具。 {% endstep %} {% endstepper %} ### 示例：Google Search 當你需要從 Google 取得常規網頁搜尋結果時，可以使用該操作。 ``` Operation: Google Search Search Query: coffee Country/Region: United States Language: English Number of results: 10 ``` {% hint style="info" icon="sliders-simple" %} 典型場景包括市場調研、SEO監控、競品分析，以及檢索增强型AI工作流。 {% endhint %} ### 示例：Bing Image Search 當工作流需要從Bing獲取圖片搜索結果時，可以使用該操作。 ``` Operation: Bing Image Search Search Query: coffee Country/Region: United States Market: en-US Result count: 10 ``` ### 示例：Google Lens Search 當工作流以圖片URL作為輸入時，可以使用Google Lens Search。 ``` Operation: Google Lens Search Image URL: https://example.com/image.png ``` ### 示例：Yandex Search 當工作流需要Yandex SERP結果時，可以使用Yandex Search。 ``` Operation: Yandex Search Search Query: coffee ``` ### 高級用法：Raw SERP Request 當你希望選擇一個已生成的SERP action，同時手動傳入高級參數時，可以使用Raw SERP Request。 ``` Operation: Raw SERP Request Raw Action: Google Lens Search Raw Query: https://example.com/image.png Extra Parameters JSON: {"hl":"en"} ``` 節點會根據所選action自動使用正確的査詢字段，例如 `q`、`text`、`url`、`product_id`、`patent_id`、`author_id` 或 `trend`。 {% hint style="warning" %} `Extra Parameters JSON` 必須是合法的JSON對象。 該字段會在可見表單字段之後合併到請求中。 節點會控制 `engine` 和默認的 `json=2` 值，囙此額外參數不能覆蓋已選擇的搜尋引擎。 {% endhint %} ### 支持的操作 `Talordata SERP` 節點會暴露由TalorData元數據生成的SERP action。 操作清單包括：
分類支持的操作
網頁搜索Google Search、Bing Search、DuckDuckGo Search、Yandex Search
圖片Google Images、Bing Images、Google Lens
新聞Google News、Bing News
電商Google Shopping、Google Play
研究Google Scholar、Google Patents
本地與出行Google Maps、Google Hotels、Google Flights
市場與趨勢數據Google Finance、Google Trends
{% hint style="info" %} 每個顯式操作只會顯示該 action 支援的參數。如需傳入未顯示在表單中的進階參數，請使用 Extra Parameters JSON。 {% endhint %} ### 故障排查 #### 401或403錯誤 請檢查： * API Key是否以 sk\_ 開頭。 * 憑證類型是否為 `Talordata SERP API`。 * API Key 是否已過期或被禁用。 > 如有需要，請在TalorData中生成新的SERP API Key，並更新n8n憑證。 #### 400錯誤 請檢查： * 所選操作是否填寫了必需的査詢字段或URL字段。 * `Extra Parameters JSON` 是否為合法 JSON。 * 參數是否與所選SERP操作匹配。 #### 429錯誤 如果工作流觸發限流，可以嘗試： * 降低n8n工作流併發。 * 在請求之間增加批次處理或延遲節點。 * 檢查你的TalorData配額和速率限制。 #### 網絡錯誤 如果n8n無法訪問TalorData，請檢查： * n8n運行環境是否可以訪問 `https://serpapi.talordata.net`。 * 如果你的環境要求出站代理，請在n8n運行環境層面配寘代理。 * 檢查部署環境中的防火牆、DNS或區域網絡限制。 ### 下一步 節點配寘完成後，你可以將TalorData SERP結果連接到： * AI Agent節點，為模型提供實时搜索上下文。 * 數據庫或表格節點，用於週期性SERP跟踪。 * 通知節點，用於新聞、排名或競品變化告警。 * Code節點，用於自定義過濾、排序、抽取或數據增强邏輯。