使用 duckduckgo_search Python 包举行 Web 搜索和查询

在这篇教程中，先容怎样使用 duckduckgo_search Python 包来举行 Web 搜索、内容总结以及同步和异步查询。DuckDuckGo 是一个注重隐私的搜索引擎，这个包可以让你通过编程方式访问 DuckDuckGo 的搜索效果。

• 使用 DDGS 举行同步搜索
  
• 使用 AsyncDDGS 举行异步搜索
  
• 提取不同类型的效果（如文本、聊天择要、文件类型等）
  
• 使用地域和安全搜索过滤器
  

1. 安装 duckduckgo_search 包

在开始之前，你须要安装该包。可以通过以下下令使用 pip 安装：

1. pip install duckduckgo-search

复制代码

2. 使用 DDGS 举行同步搜索

我们首先从同步查询开始。下面是一个简单的例子，演示怎样搜索“Python 编程”并获取文本效果。

1. from duckduckgo_search import DDGS
3. # 执行简单的搜索
4. results = DDGS().text("python programming", max_results=5)
5. print(results)

复制代码

这将返回与“Python 编程”相干的前五条搜索效果。
表明：

• DDGS() 用于初始化搜索会话。
  
• .text() 发送搜索查询并获取基于文本的效果。
  
• max_results=5 限制效果数量为 5 条。
  
  
  
  

3. 使用 AsyncDDGS 举行异步搜索

假如你须要同时处理多个查询，异步搜索会更加高效。下面是一个异步查询的例子：

1. import asyncio
2. from duckduckgo_search import AsyncDDGS
4. async def aget_results(word):
5.     results = await AsyncDDGS(proxy=None).atext(word, max_results=4)
6.     return results
8. async def main():
9.     words = ["sun"]
10.     tasks = [aget_results(w) for w in words]
11.     results = await asyncio.gather(*tasks)
12.     print(results)
14. await main()

复制代码

表明：

• AsyncDDGS() 用于举行异步查询。
  
• atext() 是 .text() 方法的异步版本。
  
• asyncio.gather() 同时实行多个异步使命。
  

这个例子异步查询了“sun”一词，并获取了最多 4 条效果。

4. 使用 DuckDuckGo 的聊天功能举行总结

你还可以使用 DuckDuckGo 的聊天功能来获取择要或回答。例如，假如你想总结丹尼尔·笛福（Daniel Defoe）的《整合者》（The Consolidator），可以使用 chat 方法：

1. results = DDGS().chat("summarize Daniel Defoe's The Consolidator", model='claude-3-haiku')
2. print(results)

复制代码

这个查询会使用聊天模子（例如 claude-3-haiku）提供《整合者》的择要。

5. 搜索特定文件类型

另一个有效的功能是搜索特定类型的文件，好比 PDF 文件。你可以通过在查询中添加 filetype 来实现：

1. results = DDGS().text('russia filetype:pdf', region='wt-wt', safesearch='off', timelimit='y', max_results=3)
2. print(results)

复制代码

表明：

• filetype:pdf 指定效果仅包括 PDF 文件。
  
• region='wt-wt' 设置搜索的地域。
  
• safesearch='off' 禁用安全搜索过滤器。
  
• timelimit='y' 限制效果为已往一年内的文件。
  

6. 使用异步查询搜索特定文件类型

你还可以使用异步方式搜索特定文件类型：

1. results = await AsyncDDGS().atext('sun', region='wt-wt', max_results=3)
2. print(results)

复制代码

7. 获取特定查询的快速回答

假如你须要快速获取某个问题的答案（例如界说或事实性信息），可以使用 answers 方法：

1. results = DDGS().answers("sun")
2. print(results)

复制代码

这将返回与“sun”相干的快速答案。

1. [{'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'}]

复制代码

异步版本：

1. results = await AsyncDDGS().aanswers("sun")
2. print(results)

复制代码

8. 总结

在这篇教程中，我们先容了怎样：

• 使用 duckduckgo_search 举行同步和异步 Web 搜索。
  
• 提取不同类型的效果，如文本、聊天择要和文件类型。
  
• 使用地域和安全搜索过滤器举行定制化查询。
  

duckduckgo_search 包是一个很棒的工具，可以将 DuckDuckGo 搜索集成到你的 Python 项目中，同时还具备注重隐私的特点。
参考链接： https://pypi.org/project/duckduckgo-search/

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。