get_search_analytics
Retrieve aggregated search analytics for your catalog. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
days | integer | No | Lookback window in days (default: 30, max: 90) |
catalog_id | string | No | Filter to a specific catalog |
curl -X POST "https://app.alana.shopping/api/mcp/sse" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"method":"tools/call","params":{"name":"get_search_analytics","arguments":{"days":30}}}'
const result = await client.callTool({
name: "get_search_analytics",
arguments: { days: 30 },
});
console.log(result.content[0].text);
result = await session.call_tool(
"get_search_analytics",
arguments={"days": 30},
)
print(result.content[0].text)
{
"period_days": 30,
"total_queries": 18420,
"zero_result_rate": 0.032,
"avg_results_per_query": 12.4,
"top_queries": [
{ "query": "cotton t-shirt", "count": 842 },
{ "query": "running shoes", "count": 671 }
]
}
get_query_performance
Get performance metrics for specific search queries. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
queries | string[] | Yes | Queries to analyze (max: 20) |
days | integer | No | Lookback window (default: 30) |
const result = await client.callTool({
name: "get_query_performance",
arguments: {
queries: ["cotton t-shirt", "running shoes"],
days: 30,
},
});
result = await session.call_tool(
"get_query_performance",
arguments={
"queries": ["cotton t-shirt", "running shoes"],
"days": 30,
},
)
{
"queries": [
{
"query": "cotton t-shirt",
"count": 842,
"avg_results": 18,
"click_through_rate": 0.41,
"zero_results": false
}
]
}
get_recommendation_stats
Retrieve statistics on product recommendations and their effectiveness. Parameters:| Parameter | Type | Required | Description |
|---|---|---|---|
days | integer | No | Lookback window (default: 30) |
product_id | string | No | Filter to recommendations for a specific product |
const result = await client.callTool({
name: "get_recommendation_stats",
arguments: { days: 30 },
});
result = await session.call_tool(
"get_recommendation_stats",
arguments={"days": 30},
)
{
"period_days": 30,
"total_recommendations_shown": 94200,
"click_through_rate": 0.087,
"conversion_rate": 0.012,
"top_recommended_products": [
{ "product_id": "SKU-001", "impressions": 4820, "clicks": 389 }
]
}