129 lines
4.2 KiB
Python
129 lines
4.2 KiB
Python
"""抓取路由：ラクマ（fril.jp）的搜索、商品详情与卖家
|
|
|
|
单独挂在 /api/rakuma 前缀下，不与乐天市场的接口合并：两站的筛选参数体系
|
|
差异很大（乐天有 genre_id / 成色 / SuperDEAL，ラクマ 有 category_id /
|
|
brand_id / 匿名配送 / 鉴定服务），合并会让大半字段对另一站无效。
|
|
"""
|
|
from fastapi import APIRouter, Depends
|
|
|
|
from app.api.dependencies import get_container, require_bearer_token
|
|
from app.core.container import ServiceContainer
|
|
from app.models.scrape import (
|
|
ApiResponse,
|
|
RakumaItemDetailData,
|
|
RakumaItemDetailRequest,
|
|
RakumaSearchRequest,
|
|
RakumaSearchResultData,
|
|
RakumaShopDetailData,
|
|
RakumaShopDetailRequest,
|
|
RakumaShopItemsData,
|
|
RakumaShopItemsRequest,
|
|
)
|
|
|
|
router = APIRouter(prefix="/api/rakuma", tags=["rakuma"])
|
|
|
|
|
|
@router.post(
|
|
"/search",
|
|
response_model=ApiResponse[RakumaSearchResultData],
|
|
dependencies=[Depends(require_bearer_token)],
|
|
)
|
|
async def search(
|
|
payload: RakumaSearchRequest,
|
|
container: ServiceContainer = Depends(get_container),
|
|
) -> ApiResponse[RakumaSearchResultData]:
|
|
"""搜索 ラクマ 商品列表
|
|
|
|
支持关键词、分类、品牌、价格区间、商品状态（6 档成色，可多选）、
|
|
在售/售罄、免运费、匿名配送等筛选；也可以直接传 search_url 透传一条
|
|
fril.jp 搜索页地址。
|
|
|
|
每页固定 40 条，站点侧最多翻到第 100 页（page > 100 直接 404）。
|
|
"""
|
|
data = await container.rakuma_client.search(payload)
|
|
return ApiResponse[RakumaSearchResultData](
|
|
success=True,
|
|
msg="success",
|
|
data=data,
|
|
code=0,
|
|
)
|
|
|
|
|
|
@router.post(
|
|
"/item_detail",
|
|
response_model=ApiResponse[RakumaItemDetailData],
|
|
dependencies=[Depends(require_bearer_token)],
|
|
)
|
|
async def item_detail(
|
|
payload: RakumaItemDetailRequest,
|
|
container: ServiceContainer = Depends(get_container),
|
|
) -> ApiResponse[RakumaItemDetailData]:
|
|
"""获取 ラクマ 商品详情
|
|
|
|
传 item_id（商品页 URL 的最后一段 hash），或直接传 item_url。
|
|
返回名称、价格、描述、图片、成色、配送信息与出品者摘要。
|
|
|
|
ラクマ 是 C2C 集市，每件商品都是单件的：没有 SKU 组合，也没有库存数量。
|
|
响应里的 seller.shop_id 可直接用于 /api/rakuma/shop_detail。
|
|
"""
|
|
data = await container.rakuma_client.item_detail(payload)
|
|
return ApiResponse[RakumaItemDetailData](
|
|
success=True,
|
|
msg="success",
|
|
data=data,
|
|
code=0,
|
|
)
|
|
|
|
|
|
@router.post(
|
|
"/shop_detail",
|
|
response_model=ApiResponse[RakumaShopDetailData],
|
|
dependencies=[Depends(require_bearer_token)],
|
|
)
|
|
async def shop_detail(
|
|
payload: RakumaShopDetailRequest,
|
|
container: ServiceContainer = Depends(get_container),
|
|
) -> ApiResponse[RakumaShopDetailData]:
|
|
"""获取 ラクマ 卖家（出品者）详情
|
|
|
|
传 shop_id（店铺页 URL 的最后一段 hash），或直接传 shop_url。
|
|
返回店铺名、昵称、头像与封面、简介、评分与评价数、本人确认状态、
|
|
以及该卖家的商品总数。
|
|
|
|
评价明细（最新 100 条）与好评/普通/差评分档计数在站点的单独子页上，
|
|
需要多打一次请求，把 include_reviews 置为 true 才会返回。
|
|
"""
|
|
data = await container.rakuma_client.shop_detail(payload)
|
|
return ApiResponse[RakumaShopDetailData](
|
|
success=True,
|
|
msg="success",
|
|
data=data,
|
|
code=0,
|
|
)
|
|
|
|
|
|
@router.post(
|
|
"/shop_items",
|
|
response_model=ApiResponse[RakumaShopItemsData],
|
|
dependencies=[Depends(require_bearer_token)],
|
|
)
|
|
async def shop_items(
|
|
payload: RakumaShopItemsRequest,
|
|
container: ServiceContainer = Depends(get_container),
|
|
) -> ApiResponse[RakumaShopItemsData]:
|
|
"""获取 ラクマ 卖家名下的商品列表
|
|
|
|
传 shop_id 或 shop_url，按页取该卖家的全部商品（含已售出，
|
|
用每条的 is_sold_out 区分）。
|
|
|
|
站点在店铺页不提供排序与筛选参数，因此这里只有页码；需要筛选请改用
|
|
/api/rakuma/search。
|
|
"""
|
|
data = await container.rakuma_client.shop_items(payload)
|
|
return ApiResponse[RakumaShopItemsData](
|
|
success=True,
|
|
msg="success",
|
|
data=data,
|
|
code=0,
|
|
)
|