diff --git a/docs/cli.md b/docs/cli.md
index fdd0705d2fd..56febd2a572 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -808,6 +808,14 @@ This command searches for packages on a remote index.
 poetry search requests pendulum
 ```
 
+{{% note %}}
+PyPI no longer allows for the search of packages without a browser. Please use https://pypi.org/search
+(via a browser) instead.
+
+For more information please see [warehouse documentation](https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods)
+and this [discussion](https://discuss.python.org/t/fastly-interfering-with-pypi-search/73597/6).
+{{% /note %}}
+
 ## lock
 
 This command locks (without installing) the dependencies specified in `pyproject.toml`.