Bottlenose 项目技术文档

1. 安装指南

首先，确保您的系统中已安装 Python。Bottlenose 支持Python版本 2.4 及以上。

通过以下命令使用 pip 安装 Bottlenose：

pip install bottlenose

或者，如果您使用的是 Python 3，可以使用以下命令：

python3 -m pip install bottlenose

确保您已经有了 Amazon Product Advertising 和 AWS 账户，并获取 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_ASSOCIATE_TAG。

2. 项目使用说明

Bottlenose 是一个轻量级、经过良好测试、维护且功能强大的 Python 包，它封装了 Amazon Product Advertising API。以下是一些基本的使用方法：

查询特定商品

import bottlenose

amazon = bottlenose.Amazon(AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ASSOCIATE_TAG)
response = amazon.ItemLookup(ItemId="B007OZNUCE")

通过关键词搜索商品

response = amazon.ItemSearch(Keywords="Kindle 3G", SearchIndex="All")

查询商品图片

response = amazon.ItemLookup(ItemId="1449372422", ResponseGroup="Images")

查询相似商品

response = amazon.SimilarityLookup(ItemId="B007OZNUCE")

3. 项目API使用文档

Bottlenose 提供了多种方法来与 Amazon Product Advertising API 进行交互。以下是一些可用的方法和示例：

地区端点

默认地区设置为美国 (webservices.amazon.com)。要指定其他端点，只需设置 Region 参数即可。例如，要指定法国端点 (webservices.amazon.fr)，将 Region 参数设置为 FR：

amazon = bottlenose.Amazon(AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ASSOCIATE_TAG, Region='FR')

购物相关方法

• 创建购物车：CartCreate
• 添加到购物车：CartAdd
• 通过 ID 获取购物车：CartGet
• 修改购物车：CartModify
• 清空购物车：CartClear

4. 项目安装方式

如前所述，使用 pip 命令安装 Bottlenose：

pip install bottlenose

或者对于 Python 3 用户：

python3 -m pip install bottlenose

确保正确设置环境变量 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_ASSOCIATE_TAG，或者直接在代码中传递这些值。

以上是 Bottlenose 项目的基本技术文档，希望对您使用该项目有所帮助。