在这篇教程中，介绍如何使用 duckduckgo_search Python 包来进行 Web 搜索、内容总结以及同步和异步查询。DuckDuckGo 是一个注重隐私的搜索引擎，这个包可以让你通过编程方式访问 DuckDuckGo 的搜索结果。
- 使用
DDGS进行同步搜索 - 使用
AsyncDDGS进行异步搜索 - 提取不同类型的结果（如文本、聊天摘要、文件类型等）
- 使用地区和安全搜索过滤器
1. 安装 duckduckgo_search 包
在开始之前，你需要安装该包。可以通过以下命令使用 pip 安装：
pip install duckduckgo-search
2. 使用 DDGS 进行同步搜索
我们首先从同步查询开始。下面是一个简单的例子，演示如何搜索“Python 编程”并获取文本结果。
from duckduckgo_search import DDGS
# 执行简单的搜索
results = DDGS().text("python programming", max_results=5)
print(results)
这将返回与“Python 编程”相关的前五条搜索结果。
解释：
-
DDGS()用于初始化搜索会话。 -
.text()发送搜索查询并获取基于文本的结果。 -
max_results=5限制结果数量为 5 条。
3. 使用 AsyncDDGS 进行异步搜索
如果你需要同时处理多个查询，异步搜索会更加高效。下面是一个异步查询的例子：
import asyncio
from duckduckgo_search import AsyncDDGS
async def aget_results(word):
results = await AsyncDDGS(proxy=None).atext(word, max_results=4)
return results
async def main():
words = ["sun"]
tasks = [aget_results(w) for w in words]
results = await asyncio.gather(*tasks)
print(results)
await main()
解释：
-
AsyncDDGS()用于进行异步查询。 -
atext()是.text()方法的异步版本。 -
asyncio.gather()同时执行多个异步任务。
这个例子异步查询了“sun”一词，并获取了最多 4 条结果。
4. 使用 DuckDuckGo 的聊天功能进行总结
你还可以使用 DuckDuckGo 的聊天功能来获取摘要或回答。例如，如果你想总结丹尼尔·笛福（Daniel Defoe）的《整合者》（The Consolidator），可以使用 chat 方法：
results = DDGS().chat("summarize Daniel Defoe's The Consolidator", model='claude-3-haiku')
print(results)
这个查询会使用聊天模型（例如 claude-3-haiku）提供《整合者》的摘要。
5. 搜索特定文件类型
另一个有用的功能是搜索特定类型的文件，比如 PDF 文件。你可以通过在查询中添加 filetype 来实现：
results = DDGS().text('russia filetype:pdf', region='wt-wt', safesearch='off', timelimit='y', max_results=3)
print(results)
解释：
-
filetype:pdf指定结果仅包括 PDF 文件。 -
region='wt-wt'设置搜索的地区。 -
safesearch='off'禁用安全搜索过滤器。 -
timelimit='y'限制结果为过去一年内的文件。
6. 使用异步查询搜索特定文件类型
你还可以使用异步方式搜索特定文件类型：
results = await AsyncDDGS().atext('sun', region='wt-wt', max_results=3)
print(results)
7. 获取特定查询的快速回答
如果你需要快速获取某个问题的答案（例如定义或事实性信息），可以使用 answers 方法：
results = DDGS().answers("sun")
print(results)
这将返回与“sun”相关的快速答案。
[{'icon': None, 'text': "The Sun is the star at the center of the Solar System. It is a massive, nearly perfect sphere of hot plasma, heated to incandescence by nuclear fusion reactions in its core, radiating the energy from its surface mainly as visible light and infrared radiation with 10% at ultraviolet energies. It is by far the most important source of energy for life on Earth. The Sun has been an object of veneration in many cultures. It has been a central subject for astronomical research since antiquity. The Sun orbits the Galactic Center at a distance of 24,000 to 28,000 light-years. From Earth, it is 1 astronomical unit or about 8 light-minutes away. Its diameter is about 1,391,400 km, 109 times that of Earth. Its mass is about 330,000 times that of Earth, making up about 99.86% of the total mass of the Solar System. Roughly three-quarters of the Sun's mass consists of hydrogen; the rest is mostly helium, with much smaller quantities of heavier elements, including oxygen, carbon, neon, and iron.", 'topic': None, 'url': 'https://en.wikipedia.org/wiki/Sun'}, {'icon': 'https://duckduckgo.com/i/d54f2507.png', 'text': 'Sun The star at the center of the Solar System.', 'topic': None, 'url': 'https://duckduckgo.com/Sun'}, {'icon': 'https://duckduckgo.com/i/c1cb6a09.jpg', 'text': 'Sun Yat-sen A Chinese revolutionary statesman, physician, and political philosopher who served as the first...', 'topic': None, 'url': 'https://duckduckgo.com/Sun_Yat-sen'}, {'icon': 'https://duckduckgo.com/i/7e37a6c6.png', 'text': 'Phoenix Suns An American professional basketball team based in Phoenix, Arizona.', 'topic': None, 'url': 'https://duckduckgo.com/Phoenix_Suns'}, {'icon': 'https://duckduckgo.com/i/945b5133.jpg', 'text': 'star A luminous spheroid of plasma held together by self-gravity. The nearest star to Earth is the Sun.', 'topic': None, 'url': 'https://duckduckgo.com/star'}, {'icon': '', 'text': 'Sun, West Virginia An unincorporated community and coal town in Fayette County, West Virginia, United States.', 'topic': 'Places', 'url': 'https://duckduckgo.com/Sun%2C_West_Virginia'}, {'icon': '', 'text': 'Sun Glacier A glacier in Greenland.', 'topic': 'Places', 'url': 'https://duckduckgo.com/Sun_Glacier'}, {'icon': 'https://duckduckgo.com/i/dae1f904.png', 'text': 'Sunoco An American master limited partnership organized under Delaware state laws and headquartered in...', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sunoco'}, {'icon': 'https://duckduckgo.com/i/ac80546e.png', 'text': 'Sun Cellular Digitel Mobile Philippines, Inc., doing business as Sun Cellular, was a wholly owned subsidiary...', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Cellular'}, {'icon': 'https://duckduckgo.com/i/3e13b9cc.png', 'text': 'Sun Microsystems Sun Microsystems, Inc. was an American technology company that sold computers, computer...', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Microsystems'}, {'icon': '', 'text': 'Sun Finance A Latvian financial technology company operating as an online and mobile lending marketplace.', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Finance'}, {'icon': 'https://duckduckgo.com/i/fc286444.jpg', 'text': 'Sun Group An Indian media conglomerate, based in Chennai. It was founded by Kalanithi Maran in 1992.', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Group'}, {'icon': 'https://duckduckgo.com/i/7af6242b.png', 'text': 'Sun Media The owner of several tabloid and broadsheet newspapers in Canada and the 49 percent owner of the...', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Media'}, {'icon': '', 'text': "Sun (St. Paul's Churchyard) A historical bookseller in London.", 'topic': 'Companies', 'url': "https://duckduckgo.com/Sun_(St._Paul's_Churchyard)"}, {'icon': 'https://duckduckgo.com/i/9a9386d2.png', 'text': 'Sun Orthodontix An orthodontics office company.', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Orthodontix'}, {'icon': 'https://duckduckgo.com/i/04f6544c.png', 'text': 'Sun Television and Appliances A speciality retailer of consumer electronics, home appliances, and office equipment founded in...', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_Television_and_Appliances'}, {'icon': 'https://duckduckgo.com/i/a5ab6c82.png', 'text': 'Sun TV Network An Indian Media conglomerate company headquartered in Chennai, Tamil Nadu, India.', 'topic': 'Companies', 'url': 'https://duckduckgo.com/Sun_TV_Network'}, {'icon': 'https://duckduckgo.com/i/5a9780be.jpg', 'text': 'Sun Newspapers Sun Newspapers was formed as a chain of weekly newspapers serving Northeast Ohio.', 'topic': 'Literature', 'url': 'https://duckduckgo.com/Sun_Newspapers'}, {'icon': '', 'text': 'Sun (German band) An Alternative rock band from Mönchengladbach, Germany with English lyrics and styles described...', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(German_band)'}, {'icon': 'https://duckduckgo.com/i/sun-thelegendaryfunkband.com.ico', 'text': 'Sun (R&B band) An R&B, soul, disco, and funk band that was formed in the mid-1970s and recorded prolifically for...', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(R%26B_band)'}, {'icon': '', 'text': 'Silver Sun A British power pop band, who formed in 1995 in Camden, London.', 'topic': 'Music', 'url': 'https://duckduckgo.com/Silver_Sun'}, {'icon': '', 'text': 'Sun (Cat Power album) The ninth studio album by American musician Cat Power.', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(Cat_Power_album)'}, {'icon': '', 'text': 'Sun (Nopsajalka album) The fourth solo studio album by Finnish musician Nopsajalka.', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(Nopsajalka_album)'}, {'icon': '', 'text': 'Sun (Thomas Bergersen album) The second studio album by Norwegian composer Thomas Bergersen, of Two Steps from Hell fame.', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(Thomas_Bergersen_album)'}, {'icon': '', 'text': '"Sun" (Belinda Carlisle song) A single by American singer Belinda Carlisle, the first after a 15-year hiatus.', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(Belinda_Carlisle_song)'}, {'icon': 'https://duckduckgo.com/i/01d2c7aa.jpg', 'text': '"Sun" (Live song) The fifth studio album by the band Live, released in 1999.', 'topic': 'Music', 'url': 'https://duckduckgo.com/The_Distance_to_Here'}, {'icon': 'https://duckduckgo.com/i/9c3ad82e.jpg', 'text': '"Sun" (Two Door Cinema Club song) A song by Northern Irish indie rock band Two Door Cinema Club from their second studio album...', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(Two_Door_Cinema_Club_song)'}, {'icon': '', 'text': '"Sun" (Gen Hoshino song) A song by Japanese musician Gen Hoshino from his fourth studio album, Yellow Dancer.', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_(Gen_Hoshino_song)'}, {'icon': 'https://duckduckgo.com/i/5a744932.jpg', 'text': 'Sun Records An American independent record label founded by producer Sam Phillips in Memphis, Tennessee on...', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_Records'}, {'icon': '', 'text': 'Sun Records (jazz) A jazz record company and label created by Sébastien Bernard in 1971 to distribute the label...', 'topic': 'Music', 'url': 'https://duckduckgo.com/Sun_Records_(jazz)'}, {'icon': '', 'text': 'Sun (film) A 1929 Italian silent drama film directed by Alessandro Blasetti and starring Marcello Spada...', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/Sun_(film)'}, {'icon': 'https://duckduckgo.com/i/a5ab6c82.png', 'text': 'Sun News (India) A 24-hour Tamil news satellite television channel headquartered at Chennai, Tamil Nadu.', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/Sun_News_(India)'}, {'icon': 'https://duckduckgo.com/i/f0f02bb7.png', 'text': 'Sun News Network A Canadian English language Category C news channel owned by Québecor Média through a partnership...', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/Sun_News_Network'}, {'icon': '', 'text': 'Sun Sports An American regional sports network owned by Diamond Sports Group, a joint venture between...', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/Fox_Sports_Sun'}, {'icon': 'https://duckduckgo.com/i/d3263064.jpg', 'text': 'Sun Television Sun Television Co. is a commercial television station headquartered in Kobe, Hyōgo Prefecture...', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/Sun_Television'}, {'icon': 'https://duckduckgo.com/i/3f192276.png', 'text': 'SUN TV (Canada) A broadcast television station based in Toronto, Ontario, Canada, which broadcast to much of...', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/CKXT-DT'}, {'icon': 'https://duckduckgo.com/i/33c36f7a.png', 'text': 'Sun TV (India) An Indian Tamil-language general entertainment pay television channel owned by Sun TV Network.', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/Sun_TV_(India)'}, {'icon': '', 'text': 'INews An Indonesian free-to-air television broadcaster founded by Media Nusantara Citra, a subsidiary...', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/INews'}, {'icon': '', 'text': 'WSUN (FM) A commercial FM radio station, licensed to Holiday, Florida, and serving the Tampa Bay Area.', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/WSUN_(FM)'}, {'icon': '', 'text': 'WSUN-TV A television station located in St. Petersburg, Florida, United States.', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/WSUN-TV'}, {'icon': '', 'text': 'WSUN (defunct) A radio station which broadcast to Tampa Bay Area, Florida from 1927 until 2001.', 'topic': 'Stage and screen', 'url': 'https://duckduckgo.com/WSUN_(defunct)'}, {'icon': 'https://duckduckgo.com/i/358824da.png', 'text': 'Connecticut Sun An American professional basketball team based in Uncasville, Connecticut, that competes in the...', 'topic': 'Sports', 'url': 'https://duckduckgo.com/Connecticut_Sun'}, {'icon': '', 'text': 'Gold Coast Suns A professional Australian rules football club that competes in the Australian Football League.', 'topic': 'Sports', 'url': 'https://duckduckgo.com/Gold_Coast_Suns'}, {'icon': 'https://duckduckgo.com/i/7e37a6c6.png', 'text': 'Phoenix Suns An American professional basketball team based in Phoenix, Arizona.', 'topic': 'Sports', 'url': 'https://duckduckgo.com/Phoenix_Suns'}, {'icon': '', 'text': 'Sun (motorcycle) The Sun Cycle & Fittings Co. Ltd. was an English manufacturer of motorcycles, mopeds and bicycles.', 'topic': 'Transportation', 'url': 'https://duckduckgo.com/Sun_(motorcycle)'}, {'icon': 'https://duckduckgo.com/i/8427074b.jpg', 'text': 'Sun-class cruise ship A class of cruise ships originally built for by Princess Cruises and now operated by P&O Cruises...', 'topic': 'Transportation', 'url': 'https://duckduckgo.com/Sun-class_cruise_ship'}, {'icon': '', 'text': 'GWR Sun Class The Great Western Railway Sun Class 2-2-2 broad gauge steam locomotives for passenger train work.', 'topic': 'Transportation', 'url': 'https://duckduckgo.com/GWR_Sun_Class'}, {'icon': 'https://duckduckgo.com/i/7db29c26.jpg', 'text': "Sunderland station ' A railway and metro station in Sunderland, Tyne and Wear, England.", 'topic': 'Transportation', 'url': 'https://duckduckgo.com/Sunderland_station'}, {'icon': '', 'text': "Sunny Bay station ' An MTR station in Yam O. It is between Tung Chung and Tsing Yi stations.", 'topic': 'Transportation', 'url': 'https://duckduckgo.com/Sunny_Bay_station'}, {'icon': 'https://duckduckgo.com/i/6b7d4fb9.jpg', 'text': 'Sunshine railway station, Melbourne Sunshine railway station is located on the Sunbury line in Victoria, Australia, serving the...', 'topic': 'Transportation', 'url': 'https://duckduckgo.com/Sunshine_railway_station%2C_Melbourne'}, {'icon': 'https://duckduckgo.com/i/www.flyfma.com.ico', 'text': "Friedman Memorial Airport ' A city-owned public-use airport in the northwest United States, located one nautical mile...", 'topic': 'Transportation', 'url': 'https://duckduckgo.com/Friedman_Memorial_Airport'}, {'icon': 'https://duckduckgo.com/i/8cc19f50.jpg', 'text': 'Sun Ra An American jazz composer, bandleader, piano and synthesizer player, and poet known for his...', 'topic': 'People', 'url': 'https://duckduckgo.com/Sun_Ra'}, {'icon': 'https://duckduckgo.com/i/c1cb6a09.jpg', 'text': 'Sun Yat-sen A Chinese revolutionary statesman, physician, and political philosopher who served as the first...', 'topic': 'People', 'url': 'https://duckduckgo.com/Sun_Yat-sen'}, {'icon': 'https://duckduckgo.com/i/6e4293c6.jpg', 'text': 'Sun Mingming A Chinese former professional basketball player.', 'topic': 'People', 'url': 'https://duckduckgo.com/Sun_Mingming'}, {'icon': 'https://duckduckgo.com/i/0ea20600.png', 'text': 'Sun Myung Moon A Korean religious leader, also known for his business ventures and support for conservative...', 'topic': 'People', 'url': 'https://duckduckgo.com/Sun_Myung_Moon'}, {'icon': 'https://duckduckgo.com/i/www.heyaosun.com.ico', 'text': 'Ho Yeow Sun A Singaporean Christian pastor and co-founder of City Harvest Church, and former Mandopop singer.', 'topic': 'People', 'url': 'https://duckduckgo.com/Ho_Yeow_Sun'}, {'icon': '', 'text': 'Joe Sun An American country music singer-songwriter.', 'topic': 'People', 'url': 'https://duckduckgo.com/Joe_Sun'}, {'icon': 'https://duckduckgo.com/i/7332240c.png', 'text': 'Sun (heraldry) A representation of the sun is used as a heraldic charge.', 'topic': 'Other uses', 'url': 'https://duckduckgo.com/Sun_(heraldry)'}, {'icon': 'https://duckduckgo.com/i/www.unina2.it.ico', 'text': 'Seconda Università degli Studi di Napoli A university located in the cities and territories of Caserta and Naples, from the region of...', 'topic': 'Other uses', 'url': 'https://duckduckgo.com/Seconda_Universit%C3%A0_degli_Studi_di_Napoli'}, {'icon': 'https://duckduckgo.com/i/7cd252de.jpg', 'text': 'Soul of the Ultimate Nation A fantasy-based massive multiplayer online role-playing game produced by Webzen, a Korean-based...', 'topic': 'Other uses', 'url': 'https://duckduckgo.com/Soul_of_the_Ultimate_Nation'}, {'icon': '', 'text': 'SU(n) The special unitary group of degree n, a concept in mathematics.', 'topic': 'Other uses', 'url': 'https://duckduckgo.com/Special_unitary_group'}, {'icon': 'https://duckduckgo.com/i/1505a204.jpg', 'text': 'Cun (unit) A traditional Chinese unit of length.', 'topic': 'Other uses', 'url': 'https://duckduckgo.com/Cun_(unit)'}, {'icon': '', 'text': 'Sun (surname) A Chinese surname and list of people with the surname.', 'topic': 'See also', 'url': 'https://duckduckgo.com/d/Sun_(surname)'}, {'icon': '', 'text': "Sun FM See related meanings for the phrase 'Sun FM'.", 'topic': 'See also', 'url': 'https://duckduckgo.com/d/Sun_FM'}, {'icon': '', 'text': "The Sun See related meanings for the phrase 'The Sun'.", 'topic': 'See also', 'url': 'https://duckduckgo.com/d/The_Sun'}, {'icon': '', 'text': "Son See related meanings for the word 'Son'.", 'topic': 'See also', 'url': 'https://duckduckgo.com/d/Son'}, {'icon': '', 'text': "Sonne See related meanings for the word 'Sonne'.", 'topic': 'See also', 'url': 'https://duckduckgo.com/d/Sonne'}, {'icon': '', 'text': "Sol See related meanings for the word 'Sol'.", 'topic': 'See also', 'url': 'https://duckduckgo.com/d/Sol'}]
异步版本：
results = await AsyncDDGS().aanswers("sun")
print(results)
8. 总结
在这篇教程中，我们介绍了如何：
- 使用
duckduckgo_search进行同步和异步 Web 搜索。 - 提取不同类型的结果，如文本、聊天摘要和文件类型。
- 使用地区和安全搜索过滤器进行定制化查询。
duckduckgo_search 包是一个很棒的工具，可以将 DuckDuckGo 搜索集成到你的 Python 项目中，同时还具备注重隐私的特点。
参考链接： https://pypi.org/project/duckduckgo-search/