duckpy

DuckDuckGo で検索するためのシンプルな Python モジュール。

インストール

Duckpy は、次のコマンドで pip を使用してインストールできます。

pip install -U duckpy

あるいは、git から最新バージョンをインストールすることもできます。

pip install -U git+https://github.com/AmanoTeam/duckpy

Debian または Ubuntu を使用している場合は、このコマンドでインストールできます (現在、Debian Unstable および Ubuntu 20.10 以降のみ)

sudo apt install python3-duckpy

使用法

 from duckpy import Client

client = Client ()

results = client . search ( "Python Wikipedia" )

# Prints first result title
print ( results [ 0 ]. title )

# Prints first result URL
print ( results [ 0 ]. url )

# Prints first result description
print ( results [ 0 ]. description )

AsyncClientクラス内で非同期バージョンも提供します。

 import asyncio
from duckpy import AsyncClient

client = AsyncClient ()

async def get_results ():
  results = await client . search ( "Python Wikipedia" )

  # Prints first result title
  print ( results [ 0 ]. title )

  # Prints first result URL
  print ( results [ 0 ]. url )

  # Prints first result description
  print ( results [ 0 ]. description )


loop = asyncio . get_event_loop ()
loop . run_until_complete ( get_results ())

結果

 Python (programming language) - Wikipedia
https://en.wikipedia.org/wiki/Python_(programming_language)
Python is an interpreted, high-level, general-purpose programming language. Created by Guido van Rossum and first released in 1991...

高度な使用法

必要に応じて、プロキシを設定したり、カスタムのユーザー エージェント文字列を設定したりすることもできます。

プロキシの設定

特にスクレイピング、ボット、その他多くのリクエストを生成するものにライブラリを使用している場合、DuckDuckGo はリクエスト IP を一時的にブロックしたり、空の結果を返したりすることがあります。これは、duckpy の問題ではなく、プロキシを使用して防ぐことができます。

Client オブジェクトでプロキシを含むリストを渡すと、duckpy はこれらのプロキシを使用してリクエストを作成します。

 import duckpy

client = duckpy . Client ( proxies = [ 'http://123.45.67.89:80' , 'https://98.76.54.32:443' ])

複数のプロキシを渡す場合、それらは .search() メソッドを使用するたびにランダムに選択されます。

カスタム ユーザー エージェントのセットアップ

 import duckpy

user_agents = [
  "Mozilla/5.0 (X11; Linux x86_64; rv:79.0) Gecko/20100101 Firefox/79.0" ,
  "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/84.0.4147.105 Safari/537.36"
]

client = duckpy . Client ( default_user_agents = user_agents )

繰り返しますが、複数の User-Agent を渡すと、それらは .search() メソッドを使用するたびにランダムに選択されます。

免責事項

当社は、DuckDuckGo またはその子会社または関連会社と提携、提携、認可、承認されておらず、いかなる形でも公式に関係していません。 DuckDuckGo の公式 Web サイトは https://duckduckgo.com でご覧いただけます。