Resource Tools

Tools for searching and managing trade policy resources.

search_tariff_resources

Search the curated collection of trade policy documents, guides, and references.

Parameters

Parameter	Type	Required	Default	Description
`query`	string	No	-	Text search across title and description
`resource_type`	string	No	-	Filter by type: `"reference"`, `"guidance"`, `"legal"`, `"educational"`, `"news"`, `"tool"`
`topics`	list[string]	No	-	Filter by topic tags
`source_authority`	string	No	-	Filter by source (e.g., `"USTR"`, `"CBP"`, `"Wikipedia"`)
`verified_only`	boolean	No	`true`	Only return verified resources
`limit`	integer	No	`20`	Maximum results

Response


{
  "resources": [
    {
      "id": 1,
      "resource_type": "reference",
      "title": "Harmonized Tariff Schedule - Wikipedia",
      "url": "https://en.wikipedia.org/wiki/Harmonized_Tariff_Schedule",
      "description": "Overview of the HTS structure and history",
      "topics": ["hts", "overview", "history"],
      "source_authority": "Wikipedia",
      "verified": true,
      "last_verified": "2024-12-01",
      "coverage_start_date": null,
      "added_by": "system"
    }
  ],
  "count": 12
}

Examples

Search by topic:


{
  "query": "steel tariffs",
  "resource_type": "guidance"
}

Filter by source authority:


{
  "source_authority": "USTR",
  "verified_only": true
}

add_tariff_resource

Add a new trade policy resource to the collection. New resources are created as unverified and require manual review.

Parameters

Parameter	Type	Required	Default	Description
`title`	string	Yes	-	Resource title
`url`	string	Yes	-	Resource URL
`description`	string	Yes	-	Brief description of the resource
`resource_type`	string	Yes	-	Type: `"reference"`, `"guidance"`, `"legal"`, `"educational"`, `"news"`, `"tool"`
`topics`	list[string]	No	`[]`	Topic tags
`source_authority`	string	No	-	Source organization (e.g., `"USTR"`, `"CBP"`)
`coverage_start_date`	string	No	-	Date the resource’s coverage begins (ISO format)

Response


{
  "success": true,
  "resource_id": 42,
  "message": "Resource added successfully",
  "note": "Resource created as unverified. It will be reviewed before appearing in verified results."
}

get_resource_statistics

Get aggregate statistics about the resource collection.

Parameters

None.

Response


{
  "total_resources": 45,
  "verified": 38,
  "unverified": 7,
  "by_type": {
    "reference": 15,
    "guidance": 12,
    "legal": 8,
    "educational": 5,
    "news": 3,
    "tool": 2
  },
  "by_authority": {
    "USTR": 10,
    "CBP": 8,
    "Wikipedia": 6,
    "WTO": 4
  },
  "by_added": {
    "system": 38,
    "manual": 7
  },
  "recently_updated": [...]
}