Junglescout

Learn how to use Junglescout with Composio

Overview

SLUG: JUNGLESCOUT

Description

Jungle Scout assists Amazon sellers with product research, sales estimates, and competitive insights to optimize inventory, pricing, and listing strategies

Authentication Details

generic_api_key
stringRequired
api_key_prefix
stringRequired

Connecting to Junglescout

Create an auth config

Use the dashboard to create an auth config for the Junglescout toolkit. This allows you to connect multiple Junglescout accounts to Composio for agents to use.

1

Select App

Navigate to the Junglescout toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4junglescout_auth_config_id = "ac_YOUR_JUNGLESCOUT_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": user_api_key}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Junglescout for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, junglescout_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Junglescout toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["JUNGLESCOUT"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Retrieve historical search volume data for a keyword

Description

Fetches the historical search volume data for a specified keyword over a given time period.

Action Parameters

end_date
stringRequired
keyword
stringRequired
marketplace
stringRequired
start_date
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Query the product database

Description

Queries the jungle scout product database to retrieve product data based on various filters. compatible parameters include marketplace, sort, page size, product tiers, seller types, categories, exclude top brands, exclude unavailable products, min price, max price, min net, max net, min rank, max rank, min sales, max sales, min revenue, max revenue, min reviews, max reviews, min rating, max rating, min weight, max weight, min sellers, max sellers, min lqs, max lqs, min updated at, and max updated at.

Action Parameters

categories
arrayRequired
exclude_keywords
array
exclude_top_brands
booleanDefaults to True
exclude_unavailable_products
booleanDefaults to True
include_keywords
array
marketplace
stringRequired
max_lqs
integer
max_net
number
max_price
number
max_rank
integer
max_rating
number
max_revenue
number
max_reviews
integer
max_sales
integer
max_sellers
integer
max_updated_at
string
max_weight
number
min_lqs
integer
min_net
number
min_price
number
min_rank
integer
min_rating
number
min_revenue
number
min_reviews
integer
min_sales
integer
min_sellers
integer
min_updated_at
string
min_weight
number
page_size
integerDefaults to 50
product_tiers
arrayDefaults to ['oversize', 'standard']
seller_types
arrayDefaults to ['amz', 'fba', 'fbm']
sort
stringDefaults to name

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve data for a specific keyword query

Description

Returns data based on a specific keyword query, including search volume and competition.

Action Parameters

categories
arrayRequired
marketplace
stringRequired
max_monthly_search_volume_broad
integerDefaults to 99999
max_monthly_search_volume_exact
integerDefaults to 99999
max_organic_product_count
integerDefaults to 99999
max_word_count
integerDefaults to 99999
min_monthly_search_volume_broad
integerDefaults to 1
min_monthly_search_volume_exact
integerDefaults to 1
min_organic_product_count
integerDefaults to 1
min_word_count
integerDefaults to 1
page_size
integerDefaults to 50
search_terms
stringRequired
sort
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve keyword data for specified asins

Description

Returns keywords for which the queried asin(s) appear in amazon search results. for a given keyword, jungle scout collects up to 3 pages of amazon keyword search results. query up to 10 asins at a time. apply filters to narrow search results.

Action Parameters

data_attributes_asins
arrayDefaults to True
data_attributes_include_variants
boolean
data_attributes_max_monthly_search_volume_broad
integerDefaults to 99999
data_attributes_max_monthly_search_volume_exact
integerDefaults to 99999
data_attributes_max_organic_product_count
integerDefaults to 99999
data_attributes_max_word_count
integerDefaults to 99999
data_attributes_min_monthly_search_volume_broad
integerDefaults to 1
data_attributes_min_monthly_search_volume_exact
integerDefaults to 1
data_attributes_min_organic_product_count
integerDefaults to 1
data_attributes_min_word_count
integerDefaults to 1
marketplace
stringRequired
page
integerDefaults to 10
sort
stringDefaults to -monthly_search_volume_exact

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve sales estimates data

Description

Fetches sales estimates data for specified parameters.

Action Parameters

asin
stringRequired
end_date
stringRequired
marketplace
stringRequired
start_date
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Retrieve share of voice data

Description

Fetches share of voice data for specified keywords.

Action Parameters

keyword
stringRequired
marketplace
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired